home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / gsz1007.arc / GSZ.DOC < prev    next >
Text File  |  1991-10-10  |  127KB  |  3,777 lines

  1.  
  2.  
  3.  
  4.  
  5.                                      CONTENTS
  6.  
  7.  
  8.       1.  ZMODEM Features at a Glance....................................   1
  9.  
  10.       2.  CUSTOMIZING GSZ................................................   3
  11.           2.1    Setting the GSZ Window Size.............................   4
  12.           2.2    Speeding up GSZ.........................................   4
  13.  
  14.       3.  TUTORIAL INTRODUCTION..........................................   5
  15.  
  16.       4.  CALLING GSZ FROM COMM PROGRAMS.................................   6
  17.           4.1    USE AN INTERFACE PROGRAM?...............................   6
  18.           4.2    Ms-Kermit 3.00..........................................   6
  19.           4.3    PROCOMM PLUS............................................   6
  20.           4.4    Qmodem..................................................   8
  21.           4.5    TELIX...................................................   9
  22.           4.6    BULLETIN BOARDS.........................................  10
  23.  
  24.       5.  DESCRIPTION....................................................  11
  25.  
  26.       6.  COMMANDS.......................................................  13
  27.           6.1    List of Commands........................................  13
  28.           6.2    Interrupt Keys..........................................  19
  29.  
  30.       7.  NUMERIC PARAMETERS.............................................  20
  31.  
  32.       8.  ENVIRONMENT VARIABLES..........................................  24
  33.  
  34.       9.  EXIT STATUS....................................................  28
  35.  
  36.      10.  EXAMPLES.......................................................  29
  37.  
  38.      11.  BACKGROUND OPERATION...........................................  30
  39.           11.1   Windows 3...............................................  31
  40.           11.2   VM......................................................  31
  41.  
  42.      12.  FLOW CONTROL...................................................  32
  43.  
  44.      13.  ERROR MESSAGES.................................................  33
  45.           13.1   Got ZRPOS...............................................  34
  46.           13.2   Subpacket too Long......................................  35
  47.           13.3   Bad CRC.................................................  35
  48.           13.4   Serial Input Error: Line Status Register xx ............  35
  49.           13.5   No Carrier Detect.......................................  37
  50.           13.6   Port %d (%X) defective..................................  37
  51.           13.7   COMMAND NOT FOUND.......................................  38
  52.           13.8   Out of Environment......................................  38
  53.  
  54.      14.  SLOW TRANSFERS.................................................  39
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      15.  IN CASE OF DIFFICULTY..........................................  40
  65.           15.1   LOCKUPS.................................................  40
  66.                  15.1.1   Insufficient Memory  40
  67.                  15.1.2   Environment TOO BIG  40
  68.                  15.1.3   Bad COM Port Configuration  40
  69.                  15.1.4   LAN Manager Conflicts  41
  70.           15.2   Incorrect Batch Files...................................  42
  71.           15.3   Cheap Internal Modems...................................  42
  72.           15.4   Commands Entered in Upper Case..........................  42
  73.           15.5   No Carrier Detect.......................................  42
  74.           15.6   PKARC 3.6...............................................  43
  75.           15.7   DOS 3.x.................................................  43
  76.           15.8   Perstor Controllers.....................................  43
  77.           15.9   IBM PS/2 Model 50Z......................................  43
  78.           15.10  Brain Damaged UARTS.....................................  44
  79.                  15.10.1  Everex Internal Modems  45
  80.           15.11  Weird Iron..............................................  45
  81.           15.12  Will the real YMODEM please stand up?...................  46
  82.           15.13  286 and 386 Extended Memory.............................  46
  83.           15.14  Disk Caches.............................................  46
  84.  
  85.      16.  ASSOCIATED DOCUMENTS...........................................  47
  86.  
  87.      17.  FILES..........................................................  48
  88.  
  89.      18.  Other Omen Technology Products.................................  50
  90.           18.1   Professional-YAM COMMS TOOLS............................  50
  91.           18.2   ZCOMM: Industrial Strength COMMS Shareware..............  50
  92.           18.3   ZMODEM Developer's Collection...........................  50
  93.  
  94.      19.  FAIR PLAY......................................................  51
  95.           19.1   Sharing GSZ Files.......................................  52
  96.           19.2   REGISTRATION............................................  53
  97.           19.3   Files on Registration Disk..............................  55
  98.           19.4   Bulletin Board Registration.............................  56
  99.  
  100.      20.  CHANGES........................................................  58
  101.  
  102.      21.  ACKNOWLEDGEMENTS...............................................  61
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                   Chuck Forsberg
  125.  
  126.                                Omen Technology Inc
  127.  
  128.  
  129.                                      ABSTRACT
  130.  
  131.  
  132.  
  133.                    ZMODEM-90(TM) - Not just another XMODEM hack
  134.  
  135.      GSZ is one of many available programs that implement the ZMODEM file
  136.      transfer protocol.  GSZ features the ZMODEM-90(TM) extensions including
  137.      ZMODEM compression and MobyTurbo(TM) accelerator.
  138.  
  139.      GSZ's ZMODEM provides advanced file management features including two
  140.      levels of Intelligent Crash Recovery(TM), and flexible control of
  141.      selective file transfers.
  142.  
  143.      The ZMODEM file transfer protocol provides reliable file and command
  144.      transfers with complete END-TO-END data integrity between application
  145.      programs.  GSZ's 32 bit CRC protects against errors that sneak by "error
  146.      free" modems and even the most advanced networks.
  147.  
  148.      ZMODEM safeguards all data and supervisory information with effective
  149.      error detection.  (XMODEM and many recently introduced protocols do not
  150.      protect vital supervisory data.)
  151.  
  152.      ZMODEM rapidly transfers files, particularly with modern modems,
  153.      timesharing systems, satellite relays, and packet switched networks.
  154.      ZMODEM's streaming operation eliminates delays caused by
  155.      Kermit/XMODEM/YMODEM/JMODEM block acknowledgements.  ZMODEM eliminates
  156.      traditional protocols' PACKET LENGTH compromises between transfer
  157.      efficiency and error recovery; ZMODEM's packet length is the entire
  158.      file.
  159.  
  160.      User Friendliness is an important ZMODEM feature.  ZMODEM
  161.      AutoDownload(TM) (Automatic file Download without user intervention)
  162.      provides a level of convenience unimaginable to users of traditional
  163.      protocols.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.        GSZ - a ZMODEM-90(TM), True YMODEM(TM), XMODEM File Transfer Program
  179.  
  180.  
  181.                                Omen Technology Inc
  182.  
  183.  
  184.      1.  ZMODEM Features at a Glance
  185.  
  186.      _______________________________________________________________________
  187.      |   Feature              | ProCm | RZSZ | DSZ  | GSZ | ZCOMM | Pro-YAM |
  188.      |________________________|_______|______|______|_____|_______|_________|
  189.      |Security Verification   | no    | no   | no   | no  | no    | YES     |
  190.      |Cybnertic Data Recovery | no    | no   | YES  | YES | YES   | YES     |
  191.      |                        |       |      |      |     |       |         |
  192.      |Command Download        | no    | YES  | no   | no  | YES   | YES     |
  193.      |                        |       |      |      |     |       |         |
  194.      |Update Directory Tree   | no    | YES* | no   | no  | YES   | YES     |
  195.      | Create Directories     | no    | YES* | no   | no  | YES   | YES     |
  196.      | Newer files Only       | no    | YES  | YES  | YES | YES   | YES     |
  197.      | Protect files          | ?     | YES  | YES  | YES | YES   | YES     |
  198.      | Common files Only      | no    | YES  | YES  | YES | YES   | YES     |
  199.      |                        |       |      |      |     |       |         |
  200.      |Collision Aviodance     | ?     | no   | YES* | YES | YES   | YES     |
  201.      |                        |       |      |      |     |       |         |
  202.      |Crash Recoverey         | YES   | YES  | YES  | YES | YES   | YES     |
  203.      | Verified Accuracy      | no    | SZ   | YES  | YES | YES   | YES     |
  204.      |                        |       |      |      |     |       |         |
  205.      |ZMODEM-90(TM)           | no    | YES  | YES  | YES | YES   | YES     |
  206.      | Compression            | no    | YES  | YES  | YES | YES   | YES     |
  207.      | MobyTurbo(TM)          | no    | YES* | YES  | YES | YES   | YES     |
  208.      | 7-bit Paths OK         | no    | YES* | YES* | YES | YES   | YES     |
  209.      |                        |       |      |      |     |       |         |
  210.      |OPERATING SYSTEMS       |       |      |      |     |       |         |
  211.      | Text Translation       | no    | YES  | YES  | YES | YES   | YES     |
  212.      | Record Format Support  | no    | YES  | YES  | YES | YES   | YES     |
  213.      | DOS Shared Files       | ?     | -    | YES* | YES | no    | no      |
  214.      | OS/2                   | no    | no   | no   | no  | no    | YES     |
  215.      | VMS                    | no    | YES  | no   | no  | no    | YES     |
  216.      | Unix/Xenix             | no    | YES  | no   | no  | no    | YES     |
  217.      |                        |       |      |      |     |       |         |
  218.      |True YMODEM(TM)         | no    | YES  | YES  | YES | YES   | YES     |
  219.      |Demand Upgrade(TM)      | no    | YES  | YES  | YES | YES   | YES     |
  220.      |File Transfer Display   | YES   | no   | no   | YES | YES   | YES     |
  221.      | TOTAL File Xfer Data   | no    | YES  | YES  | YES | YES   | YES     |
  222.      |________________________|_______|______|______|_____|_______|_________|
  223.  
  224.      ProCm = ProComm Plus
  225.      * Not available on all flavors or platforms
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.      Chapter 1 Pg 2         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  238.  
  239.  
  240.      *************************************************************************
  241.                            GSZ registration is special.
  242.      With most programs, registration only applies only to today's version.
  243.      Not GSZ!
  244.  
  245.      GSZ registration bypasses the shareware announcement and unlocks
  246.      advanced features in all future versions of GSZ.  You don't have to pay
  247.      and pay again for new GSZ versions.  Omen's Demand Upgrade(TM)
  248.      technology allows you to download and activate future GSZ versions
  249.      without further registration!
  250.      *************************************************************************
  251.  
  252.  
  253.      DSZ Upgrade!!  Include your PAID REGISTRATION DSZ SNP CARD and take
  254.      $15.00 off the registration fee!!  (The card must be mailed with the
  255.      order.) (Be sure to copy your DSZ SNP for safe keeping.)
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      Chapter 2 Pg 3         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  297.  
  298.  
  299.      2.  CUSTOMIZING GSZ
  300.  
  301.      The GCOLORS program customizes GSZ for your environment.  GCOLORS
  302.      performs the following functions:
  303.  
  304.        + Customize GSZ's color complement (registration not required).
  305.  
  306.        + Save and fetch the color selection separately to allow "colorizing"
  307.          new copies of GSZ
  308.  
  309.        + Insert your GSZ serial number and activation key
  310.  
  311.        + Initialize GSZ with your default communications port (registration
  312.          required).[1]
  313.  
  314.        + Initialize GSZ with your default download directory.  (registration
  315.          required).
  316.  
  317.      GCOLORS is menu driven and is mostly self explanatory.  First GCOLORS
  318.      asks for the file name to modify; answer GSZ.EXE.
  319.  
  320.      Sight impaired users can disable the blinking selection pointer by
  321.      calling "gcolors -q".
  322.  
  323.      The top menu provides several choices.
  324.  
  325.      Choose colors Modify the GSZ file transfer display color scheme.
  326.  
  327.      Fetched saved colors Fetch the color scheme stored in GCOLORS.T.
  328.  
  329.      adjust for Monochrome display Adjust the color scheme for better
  330.                visibility on monochrome displays.
  331.  
  332.      Register  Accept your GSZ activation key and insert it in GSZ.
  333.  
  334.      Save changes Save the color scheme in GSZ and GCOLORS.T.
  335.  
  336.  
  337.      Quit
  338.  
  339.      If your copy of GSZ is registered, two additional choices appear.
  340.  
  341.      set download Directory
  342.  
  343.  
  344.  
  345.      __________
  346.  
  347.       1. The default port may be up to 7 characters, so portx definitions may
  348.          be used.  The validity of the port specification is not checked.
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.      Chapter 2 Pg 4         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  356.  
  357.  
  358.      set default Port
  359.  
  360.      Some Color Selection menu choices are not shown on the display:
  361.  
  362.      space     increment foreground color
  363.  
  364.      Enter     select the next field
  365.  
  366.      F         decrement foreground color (f increments)
  367.  
  368.      B         decrement background color (b increments)
  369.  
  370.      GCOLORS requires the file GREGDAT.$$$ to serialize GSZ.
  371.  
  372.  
  373.      2.1  Setting the GSZ Window Size
  374.  
  375.      Some BBS programs display status information such as the name of the
  376.      caller at the bottom of the screen.  Normally GSZ clears all 25 screen
  377.      lines,  but this can be modified with the GSZWINDOW environment
  378.      variable:
  379.  
  380.      SET GSZWINDOW=24    protects the 25th line and disables the frame
  381.                          shadow.
  382.  
  383.      SET GSZWINDOW=23    protects the 24th and 25th lines and disables the
  384.                          frame and frame shadow.
  385.  
  386.      SET GSZWINDOW=21    Protects lines 22-25, disables the frame, frame
  387.                          shadow, and the static data GSZ normally shows in
  388.                          lines 22 and 23.
  389.      Setting GSZWINDOW does not affect the GSZ t command.
  390.  
  391.      2.2  Speeding up GSZ
  392.  
  393.      GSZ has a V numeric parameter that can be set to 1 to use direct video
  394.      I/O for the status display.  This speeds up displays but may cause
  395.      serial input errors when CGA equipped computers are used at high speeds.
  396.  
  397.      EXAMPLE: GSZ pV1 t
  398.  
  399.      sets direct video output.
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      Chapter 3 Pg 5         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  415.  
  416.  
  417.      3.  TUTORIAL INTRODUCTION
  418.  
  419.      If you are just starting out with GSZ, or if you have difficulty getting
  420.      GSZ to work, please follow the procedure given below.
  421.  
  422.      Do not run any TSR or other COMM program.  This includes LAN programs.
  423.      Reboot a clean DOS if necessary.
  424.  
  425.      Start with the following command given directly from the DOS prompt:
  426.  
  427.                              gsz port 1 speed 2400 d t
  428.  
  429.      Type it exactly as it appears above; do NOT use upper case.
  430.  
  431.      (Change the port number and speed as necessary.  Use only COM1 or COM2
  432.      for testing.)
  433.  
  434.      This connects you to the modem.  Dial a bulletin board by typing AT
  435.      commands to the modem ("ATDP621-3746 <enter>")[1] to make it dial the
  436.      BBS.  Log in as usual.  Then, request a ZMODEM download of a file you
  437.      don't already have.  The file will download automatically, you don't
  438.      have to do anything.  This procedure verifies the correct operation of
  439.      GSZ.
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.      __________
  464.  
  465.       1. If your modem has a non standard setting the ATDT621-3746 command
  466.          you type to the modem may not echo on the screen.
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.      Chapter 4 Pg 6         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  474.  
  475.  
  476.      4.  CALLING GSZ FROM COMM PROGRAMS
  477.  
  478.      It may be necessary to add the DOS command: SET COMSPEC=C:\COMMAND.COM
  479.      (change as needed) to your AUTOEXEC.BAT file to allow programs to call
  480.      GSZ.
  481.  
  482.      Note: NO SPACES in the SET command!
  483.  
  484.      4.1  USE AN INTERFACE PROGRAM?
  485.  
  486.      A number of third party programs have been developed to provide a
  487.      congenial interface to DSZ if you have enough memory to spare.  The
  488.      XFER, POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in
  489.      interfacing DSZ to ProComm's editor gateway.  These programs are
  490.      available on many bulletin boards.
  491.  
  492.      Hint: the DOS PATH environment variable must include ProComm's directory
  493.      to allow POE to locate all the POE files,.  The POE files should be
  494.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  495.      variable is insufficient.
  496.  
  497.  
  498.      Calling DSZ with these programs requires more memory than calling DSZ
  499.      directly.
  500.  
  501.      4.2  Ms-Kermit 3.00
  502.  
  503.      The "push" command (^[p) in MS-Kermit 3.00 sends an XOFF character to
  504.      the modem before calling DOS.
  505.  
  506.      Using this to activate GSZ's term mode with a "gsz t" command causes
  507.      most remote hosts to stop.  The remote host can be un-wedged by
  508.      keyboarding XON (Ctrl-Q) from GSZ's terminal mode.
  509.  
  510.      Add these macros to your MSKERMIT.INI file.  Courtesy Keith Petersen
  511.      W8SDZ
  512.  
  513.      define sx run gsz F port 2 sx 1 2,define 1,define 2,
  514.      define rz run gsz F ha on port 2 pY129 rz -r
  515.      define sz run gsz F ha bo port 2 pY129 pB4096 sz 1 2,define 1,define 2,
  516.      define t run gsz F ha on port 2 pY129 t -r
  517.  
  518.  
  519.      4.3  PROCOMM PLUS
  520.  
  521.      It's easy to add GSZ to ProComm Plus.
  522.  
  523.      Datastorm has not licensed ZMODEM-90(TM) technology despite allegations
  524.      that DSZ is now "built in" to ProComm Plus version 2.  Many users of
  525.      ProComm Plus version 2.x use GSZ to get MobyTurbo(TM), Intelligent Crash
  526.      Recovery(TM), and other ZMODEM-90(TM) features.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      Chapter 4 Pg 7         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  533.  
  534.  
  535.      Make sure the GSZ program is in your search path.  If you don't see GSZ
  536.      announce itself when called from ProComm, GSZ is not in your search
  537.      path.
  538.  
  539.      Here are some handy settings for ProComm Plus.
  540.  
  541.      First, you may need to set the DOS environment before running ProComm.
  542.      Give these commands to DOS before running ProComm Plus.  (These lines
  543.      may be added to your AUTOEXEC.BAT file.)
  544.  
  545.      Note: NO SPACES in the SET command!
  546.      SET DSZPORT=2                   (Only needed for COM2)
  547.      SET DSZLOG=GSZ.LOG      (Only if you wish a log file)
  548.  
  549.      Then set ProComm's external protocol strings.  From terminal mode hit
  550.      ALT-S, then select the PROTOCOL OPTIONS menu item.
  551.  
  552.      From that menu select EXTERNAL PROTOCOL OPTIONS.  Then set ProComm's
  553.      external protocol strings to:
  554.      A- External protocol 1 upload filename:  ZMODEMU
  555.      B- External protocol 1 download filename: ZMODEMD
  556.      C- External protocol 2 download filename: ZMODEMMD
  557.  
  558.      The following batch files are included in the GSZ zipfile:
  559.      ZMODEMU.BAT (contains:  GSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9)
  560.      ZMODEMD.BAT (contains:   GSZ rz)
  561.      ZMODEMDR.BAT (contains:   GSZ rz -r)
  562.      ZMODEMMD.BAT (contains:   GSZ rz -mr)
  563.      ZMODEMAD.BAT (contains: GSZ t)
  564.  
  565.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  566.  
  567.      If using ProcommPlus 2.x, select the ZMODEM PROTOCOL OPTIONS menu and
  568.      turn off Auto downloading.
  569.  
  570.      When sending (uploading) files with ZMODEMU.BAT give the ProComm window
  571.      the full pathname (c:/foo/bar/file.ext) for *each* file not residing in
  572.      the current directory.
  573.  
  574.      When downloading files with one of the other batch files shown above,
  575.      Procomm will also prompt for parameters; just hit ENTER.  Or, you can
  576.      enter options such as "-mr" if they are't included in the batch file
  577.      itself.
  578.  
  579.      Once you've got the hang of things the "ProComm way", try the "gsz t"
  580.      command described above to give you automatic ZMODEM-90(TM) downloads
  581.      (Look Ma, no keystrokes!!!)..
  582.  
  583.      You can also set the editor hot key (ALT-A) or view program hot key
  584.      (ALT-V) by using the ALT-S "FILE/PATH OPTIONS" menu.  The strings for
  585.      these keys are long enough to store an entire GSZ command line without
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Chapter 4 Pg 8         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  592.  
  593.  
  594.      need for a batch file.
  595.  
  596.      COM3 and COM4 on Procomm Plus are non standard; in case of difficulty
  597.      use COM1 or COM2 or use the portx command.
  598.  
  599.      GSZ may not operate properly when called from ProComm if ProComm has
  600.      files open at the time.
  601.  
  602.      A number of reports have been received of problems running GSZ from
  603.      ProComm Plus because of insufficient memory.  Please refer to the
  604.      subchapter on LOCKUPS.
  605.  
  606.      When running under ProComm's Host mode, failure to use the GSZ CON
  607.      command may cause ProComm to lock up the computer, or at least interfere
  608.      with file transfers, etc.
  609.  
  610.      EXAMPLE: GSZ CON sz %1
  611.  
  612.  
  613.      Hint: the DOS PATH environment variable must include ProComm's directory
  614.      to allow POE to locate all the POE files,.  The POE files should be
  615.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  616.      variable is insufficient.
  617.  
  618.  
  619.      4.4  Qmodem
  620.  
  621.      Instability in the Qmodem interface may require changes in the batch
  622.      files depending on which version of Qmodem is used.
  623.  
  624.      If you define a protocol with 'Z' as its letter, the latest Qmodem will
  625.      detect automatic ZMODEM downloads.  Defining an external 'Z' protocol
  626.      disables Qmodem's internal ZMODEM, allowing GSZ to be called.
  627.  
  628.      The following is based on a message from Mike Cody, sysop of HomePlate
  629.      313-385-9969 3/12/24/96 HST
  630.  
  631.      Go into Qinstall and go to frame 3 Directories. Then select External
  632.      protocols #3 I think. Now you will see a definition area to tell Qmodem
  633.      the Letter,batchfile combo to use.
  634.  
  635.      Now put Z in the letter definition, Zup.bat in the u/l batch zdown.bat
  636.      in the d/l batch, and Y in the batch protocol. Now save it at the menu
  637.      with f10 and S.
  638.  
  639.      Then go to DOS and create the following batch files in your Qmodem
  640.      directory...
  641.  
  642.      zdown.bat: GSZ port %2 speed %1 rz -rr
  643.  
  644.      zmdown.bat: GSZ port %2 speed %1 rz -mrr      ((FOR MOBYTURBO!!))
  645.  
  646.  
  647.  
  648.  
  649.  
  650.      Chapter 4 Pg 9         GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  651.  
  652.  
  653.      zup.bat: GSZ port %2 speed %1 sz %4
  654.  
  655.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  656.  
  657.      These are the batch files that will be called by Qmodem.  If you did
  658.      everything right when you hit PGDN or PGUP you will see an external
  659.      protocol called Z) Zmodem in the box. For an easier time do a search for
  660.      either External.arc or maybe the string "Qmodem" in the file database as
  661.      there is a file with several external protocols and batch files
  662.      available in the Mahoney file section (EXEC-PC BBS).
  663.  
  664.      The following batch files for Qmodem are included in the GSZ zipfile:
  665.  
  666.      ZDOWN.BAT contains:     GSZ port %2 speed %1 rz -rr
  667.      ZUP.BAT contains:       GSZ port %2 speed %1 sz %4
  668.  
  669.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  670.  
  671.      A variation on the receive batch file:
  672.      c:elecomqmodem\*y.com ha slow est 0 %3 rz -mrr
  673.      A variation on the send batch file:
  674.      c:elecomqmodem\*y.com ha cts est 0 %3 sz %4
  675.  
  676.  
  677.      If Qmodem says "unable to allocate swap space": QMODEM 4.2 will swap all
  678.      but approx. 5K to memory or disk when you shell out to GSZ. Go into
  679.      QINSTALL and make sure that /O /R Optimum Shell and Disk Shell are both
  680.      set to ON.
  681.  
  682.      For older Qmodem versions (before 4.2) change the %4 in upload scripts
  683.      to %3.
  684.  
  685.      4.5  TELIX
  686.  
  687.      Telix has an internal ZMODEM, but some users prefer to use GSZ for
  688.      performance and/or reliability reasons.  Mat Fisher has published a
  689.      Telix script to call GSZ for automatic downloads.
  690.  
  691.      For those of you who use GSZ with Telix, here is a sample script file to use
  692.      instead of batch files:
  693.  
  694.      //////////////////////////////////////////////////////////////////////////
  695.      //Protocol salt file for Telix's external protocols by Matt Fisher
  696.      //Last edited (02/24/90)
  697.      //used for the GSZ ZMODEM protocol.  (It will work for u/ling and d/ling)
  698.      //////////////////////////////////////////////////////////////////////////
  699.  
  700.      str upload[80]  =
  701.         "c:\telix\protocol\DSZ port 1 pW1 pB4096 ha off sz -b -m -rr ";
  702.  
  703.      str download[80]=
  704.  
  705.  
  706.  
  707.  
  708.  
  709.      Chapter 4 Pg 10        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  710.  
  711.  
  712.         "c:\telix\protocol\DSZ port 1 pW1 pB4096 ha off rz -b -m -rr ";
  713.  
  714.      //////////////////////////////////////////////////////////////////////////
  715.  
  716.      Main ()
  717.      {
  718.       if (_ext_filespec == "")
  719.        { strcat(download,_down_dir); dos(download,0); }
  720.       else
  721.        { strcat(upload,_up_dir); strcat(upload,_ext_filespec);  dos(upload,0); }
  722.      alarm(1);
  723.      }
  724.      //////////////////////// THE END /////////////////////////////////////////
  725.  
  726.      Simple but effective...
  727.      --- TAGMAIL v2.20
  728.       * Origin: CRIMP/John Galt [Node 1] (1:120/144)
  729.      INTERNET: Matt.Fisher@f144.n120.z1.FIDONET.ORG
  730.  
  731.      NOTE: The DSZ command strings given above are quite unusual.  Instead of
  732.      the  "pW1  pB4096 ha off" one would be more likely to use "ha on" or "ha
  733.      sw" depending on the modem's flow control settings.
  734.  
  735.      4.6  BULLETIN BOARDS
  736.  
  737.      Note to the wise BBS operator: be sure you understand the GSZ restrict
  738.      command, how and WHY to use it!
  739.  
  740.      When installing GSZ on a bulletin board or host system, be sure to check
  741.      for proper operation when the caller hangs up while a file is being sent
  742.      or received.
  743.  
  744.      Currently, Only the TurboC version supports file sharing (shared read
  745.      access on files sent by  gsz).
  746.  
  747.      Some bulletin board interface routines do not call GSZ to send a file
  748.      until they have verified the file's presence by opening the file.  If
  749.      this checking is done in DOS's default exclusive open mode, gsz's file
  750.      sharing will be defeated.
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.      Chapter 5 Pg 11        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  769.  
  770.  
  771.      5.  DESCRIPTION
  772.  
  773.      GSZ is a "protocol driver" that uses ZMODEM-90(TM), True YMODEM(TM), or
  774.      XMODEM to transfer files over a serial port with a variety of programs.
  775.  
  776.      GSZ has two main commands for ZMODEM transfers: "sz" sends file(s), and
  777.      "rz" receives them.
  778.  
  779.      When calling bulletin boards to download files with ZMODEM you can avoid
  780.      the bother of starting GSZ for each transfer by GSZ's terminal emulator,
  781.      before asking the BBS for the download.
  782.  
  783.                              gsz t
  784.  
  785.      The "t" command allows you to keyboard the file request directly to the
  786.      BBS.  (The "t" stands for "terminal emulation".) Just give the "gsz t"
  787.      command from DOS or your comms program's DOS GATEWAY.  GSZ's ZMODEM
  788.      AutoDownload then receives the file automatically, using the filename
  789.      provided by the BBS, without any wasted keystrokes or delay.  Try it,
  790.      you'll like it!  (The "t" command is described below.)
  791.  
  792.      YMODEM downloads are almost as easy.  Use the "t" command as shown
  793.      above, and hit the F3 key after telling the board to download a file
  794.      with YMODEM.
  795.  
  796.      ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  797.      modification time.
  798.  
  799.      GSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes
  800.      mislabeled as ymodem) and CRC-16 with the sx -k and rc commands.
  801.  
  802.      GSZ is derived from Omen Technology's "Professional-YAM" high
  803.      reliability communications tools (also known as PowerCom(TM)) and Omen
  804.      Technology's ZCOMM User Supported Communications Software.  GSZ supports
  805.      a subset of Pro-YAM's file transfer related commands.  This
  806.      documentation makes extensive references to contemporary editions of the
  807.      Pro-YAM or ZCOMM manual, and is incomplete without it.  (Registered
  808.      copies include an alternate, copyrighted file.)
  809.  
  810.      GSZ is usually called from a communications or bulletin board program.
  811.  
  812.      GSZ uses its own modem I/O.  The original interrupt vector, UART parity,
  813.      and interrupt configuration are restored on exit.  The original state of
  814.      the 8259 interrupt mask bit for this vector is also restored on exit.
  815.  
  816.      GSZ uses DOS standard output (stdout) for messages.  GSZ never writes
  817.      directly to the screen.  GSZ expects its standard output to point to the
  818.      console, a logging file, or NUL, but never the modem port.  If gsz's
  819.      standard output is redirected to the modem (as with ProComm's Host mode
  820.      DOS shell), the combination will lock up the computer.  When necessary,
  821.      gsz's standard output can be redirected back to the console device with
  822.  
  823.  
  824.  
  825.  
  826.  
  827.      Chapter 5 Pg 12        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  828.  
  829.  
  830.      the CON command.
  831.  
  832.      Users of pcAnywhere must use DSZ's A command to disable pcAnywhere host
  833.      mode during file transfers.
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.      Chapter 5 Pg 13        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  887.  
  888.  
  889.      6.  COMMANDS
  890.  
  891.            ***********************************************************
  892.                                     NOTE WELL
  893.       Except as noted, all commands and options must be typed in lower case.
  894.                              DO NOT USE UPPER CASE!!
  895.                                Case is significant!
  896.            ***********************************************************
  897.  
  898.      Optional commands or arguments are shown in square brackets [].
  899.  
  900.      When used (in any combination), the A, CON, port, speed, handshake,
  901.      estimate, and d commands must be used in exactly this order.
  902.  
  903.      gsz [CON] [F] [port N] [speed S] [handshake XX] [pxN... ] [z pxN... ]
  904.      [D] [d] [restrict] command
  905.  
  906.  
  907.      6.1  List of Commands
  908.  
  909.      A     Suspend pcAnywhere operation during file transfers (available only
  910.            with DSZ.EXE).  The A command is used to avoid lockups caused by
  911.            pcAnywhere host mode.  This command should be given to the DSZ
  912.            running under pcAnywhere host mode.  Effective for PCA version 4.
  913.  
  914.            NOTE: A bug in the PCA Version 4 API causes the remote to
  915.            effectively lock up when DSZ executes the suspend-host command.
  916.            Currently the workaround for this bug it to use VT-220 emulation
  917.            on the pcAnywhere host and remote instead of pcAnywhere4
  918.            emulation.  Another possibility is to run AWREMOTE under DESQview,
  919.            set the window to SUSPEND AWREMOTE.EXE, and swap windows to a DOS
  920.            window from which DSZ, ZCOMM, or Professional-YAM can be run while
  921.            AWREMOTE.EXE is forced to remain inert.
  922.  
  923.            The shareware program DOORWAY 2.2 interfaces well with DSZ, and
  924.            provides many of the same functions, including the ability to run
  925.            direct screen writing applications remotely.
  926.  
  927.  
  928.            EXAMPLE: dsz A sz *.foo Sends files from a pcAnywhere hosted
  929.            machine to you.
  930.  
  931.  
  932.            Fm: Al de la Torre
  933.  
  934.            1 sending from host to remote
  935.                   type: "dsz A sz filename.ext" ENTER
  936.                   shell to dos on remote machine (ctrl-Rshift)
  937.                   type: "dsz A rz" ENTER
  938.  
  939.            2 sending from remote to host
  940.  
  941.  
  942.  
  943.  
  944.  
  945.      Chapter 6 Pg 14        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  946.  
  947.  
  948.                   type: "dsz A rz" ENTER
  949.                   shell to dos on remote machine (ctrl-Rshift)
  950.                   type: "dsz A sz filename.ext" ENTER
  951.  
  952.  
  953.      CON   Redirect  message  output  to  the  DOS  "CON"  (console)  device,
  954.            overriding  any previous redirections.  This is necessary to avoid
  955.            lockups caused by ProComm host mode.  Most programs do not require
  956.            this hack.  This command is unique to GSZ.
  957.  
  958.      F     Leave the 16550A UART FIFO enabled on exit.  Since GSZ has no  way
  959.            to  read  the 16550A DMA mode and trigger level bits, these values
  960.            are not restored.
  961.  
  962.      port N select port N (n =  1,2,3,4,5,6,7,8,  10,11,12,13,14,15,16,17,18)
  963.            Default  is port 1 (COM1) or read from the DSZPORT dos environment
  964.            variable.  COM11 to COM18 refer to the COM1 to COM8 ports  on  the
  965.            PS/2.
  966.  
  967.            *****************************************************************
  968.                                           NOTE
  969.            Only COM1 and COM2 are standard on all  PC  compatible  computers.
  970.            Multiple  standards  exist for COM3 and above, so use only COM1 or
  971.            COM2 when first installing GSZ.
  972.            *****************************************************************
  973.  
  974.            GSZ COM3 uses 3E8 and IRQ4.  GSZ COM4 uses 2E8 and IRQ3.
  975.  
  976.            GSZ COM7 uses 2E8 and IRQ5.  GSZ COM8 uses 3E8 and IRQ5.
  977.  
  978.            If you wish to use COM3 or COM4 and your  computer  is  not  wired
  979.            according  to  one  of  these  choices,  you  MUST use the "portx"
  980.            command to specify base address and interrupt vector.
  981.  
  982.            EXAMPLE: to use COM2:
  983.            gsz port 2 rz
  984.  
  985.            In multitasking  operation,  accessing  a  port  used  by  another
  986.            running program will hang the machine.
  987.  
  988.  
  989.      portx base,irq To select an arbitrary port address and interrupt vector,
  990.            the  portx  command  must  be  used  instead  of the port command.
  991.            Please refer to GSZBG.DOC (provided on the Registration  Diskette)
  992.            or  the  Professional-YAM  or  ZCOMM  (ZCOMMDOC.ZIP)  manuals  for
  993.            details on this command.
  994.  
  995.            EXAMPLE: gsz portx 3e8,4 speed 2400 rz
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.      Chapter 6 Pg 15        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1005.  
  1006.  
  1007.      speed S Set the specified speed.  This command is rarely needed because
  1008.            GSZ reads the port's current speed by default.  Please refer to
  1009.            the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters
  1010.            in DSZBG.ZOO or the ZCOMM or Pro-YAM manual for important
  1011.            information about the speed command.
  1012.  
  1013.            Please study all the chapters of this document when using speeds
  1014.            above 2400 bps.
  1015.  
  1016.            GSZ supports a maximum speed of 115200.  Not all hardware can
  1017.            support that speed without errors.
  1018.  
  1019.  
  1020.      handshake XX Enable one of several choices of hardware handshake.  (The
  1021.            default is XOFF/XON software handshake).  This command is
  1022.            documented in the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The
  1023.            ZCOMM manual is available on all bulletin boards registered for
  1024.            GSZ as ZCOMMDOC.ZIP.) On GSZ the "handshake" command may be
  1025.            abbreviated to "ha".
  1026.  
  1027.      D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  1028.            lost.  This may be used to prevent spurious events (phone ringing)
  1029.            from interfering with the calling bulletin board's recovery from
  1030.            carrier loss.
  1031.  
  1032.      d     Disables carrier dropout monitoring, for modems that do not
  1033.            properly drive the "Carrier Detect" input on the PC.  If you see a
  1034.            No Carrier Detect message, you need to give the d command.  Before
  1035.            using the d command, make sure you have the proper port
  1036.            selected!!!
  1037.  
  1038.  
  1039.      estimate length [speed] Use the specified length and/or optional
  1040.            specified effective transfer speed to estimate transfer time for
  1041.            the next file to be sent or received.  The length argument is
  1042.            mainly used with XMODEM downloads; YMODEM and ZMODEM normally
  1043.            transfer the file length in the filename packet.  The estimate
  1044.            command must come after any port, speed, or handshake commands.
  1045.  
  1046.            The estimate command does not affect actual througput.  It only
  1047.            affects GSZ's prediction of how much time a file transfer will
  1048.            take.
  1049.  
  1050.            The following makes GSZ calculate file transfer times based on 290
  1051.            character per second throughput.  Some error correcting 2400 bps
  1052.            modems can attain this throughput when MobyTurbo(TM) is used.
  1053.  
  1054.            EXAMPLE: gsz port 2 speed 9600 estimate 0 2900 rz
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.      Chapter 6 Pg 16        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1064.  
  1065.  
  1066.            EXAMPLE: gsz port 2 speed 9600 estimate 0 2900 sz bigmama.zip
  1067.  
  1068.  
  1069.  
  1070.      pxN   Set numeric parameter x to N.
  1071.  
  1072.            GSZ has two sets of numeric parameters, a base set and a "zmodem"
  1073.            set.  Parameters in the base control such things as date stamping
  1074.            of files, error exit value, etc.  The "zmodem" numeric parameters
  1075.            control timeouts, window sizes, and other ZMODEM, YMODEM, and
  1076.            XMODEM protocol parameters.
  1077.  
  1078.            These parameters are mostly a subset of the Pro-YAM/ZCOMM numeric
  1079.            parameters, and are listed below.  They assume their defaults each
  1080.            time GSZ is called.  Without an argument, p displays the numeric
  1081.            parameters and their values.
  1082.  
  1083.            EXAMPLE: gsz p
  1084.  
  1085.  
  1086.      z pxN Set zmodem numeric parameter x to N.  All further numeric
  1087.            parameter commands are taken as zmodem parameters.  The zmodem
  1088.            numeric parameters correspond to the Pro-YAM or ZCOMM "zmodem"
  1089.            parameters and rarely need changing.  These parameters assume
  1090.            their defaults each time GSZ is called.  Without an argument, z p
  1091.            displays the zmodem numeric parameters and their values.
  1092.  
  1093.  
  1094.      restrict Restrict incoming pathnames (YMODEM/ZMODEM) to the current disk
  1095.            and directory tree, and disallow modification or overwriting of
  1096.            existing files.  This command is vital for bulletin boards
  1097.            uploading files.  The restrict command causes partially received
  1098.            files to be deleted.  When GSZ is restricted, it will refuse to
  1099.            transfer files containing the string autoexec.bat and command.com
  1100.            in upper or lower case.  This provides some defense from malicious
  1101.            uploaded files.
  1102.  
  1103.            EXAMPLE: gsz restrict rz
  1104.  
  1105.  
  1106.      t     [-T] [-8g] [-h] [-H] Talk with ZMODEM AutoDownload.
  1107.  
  1108.            The optional -T forces GSZ to exit after it has recognized a
  1109.            ZMODEM AutoDownload(TM) request.
  1110.  
  1111.            The optional -8g (available on registered copies only) enables
  1112.            reception of "BBS (ANSI) graphics" displays.  (A video device
  1113.            driver such as ANSI.SYS must be loaded to support some types of
  1114.            graphics.)
  1115.  
  1116.            The optional -h enables local echo of keyboarded characters ("half
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.      Chapter 6 Pg 17        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1123.  
  1124.  
  1125.            duplex").  In addition, -H makes the Enter key perform a local
  1126.            newline (CR/LF).
  1127.  
  1128.            A small subset of ZCOMM/Pro-YAM term function subcommands are
  1129.            recognized:
  1130.  
  1131.            Keyboard F1 or ALT-X to exit.
  1132.  
  1133.            F3 receives file(s) with True YMODEM(TM),
  1134.  
  1135.            ALT-P toggles parity between the 8n default and 8g (enables ANSI
  1136.            "graphics").
  1137.  
  1138.            ALT-H toggles two local echo ("Half Duplex") modes; the second
  1139.            displays a newline (CR/LF) when Enter is keyboarded.
  1140.  
  1141.            Keyboarded ASCII characters are sent to the modem.
  1142.  
  1143.            ALT-B sends a break.
  1144.  
  1145.            Characters from the modem print on the screen.  A device driver
  1146.            such as ANSI.SYS may be used to recognize escape sequences.
  1147.            Standard ANSI.SYS is limited to a small subset of ANSI escape
  1148.            sequences; NANSI.SYS, FANSI-Console and other replacement console
  1149.            drivers provide faster screen updates and better ANSI terminal
  1150.            emulation.
  1151.  
  1152.            GSZ's ZMODEM AutoDownload(TM) detects the start of a ZMODEM file
  1153.            download and accepts the file(s) without operator intervention.
  1154.  
  1155.      rz    [-abeEmMnpPrt+YZy] [dir] [file ...]     (ZMODEM-90 receive) **
  1156.  
  1157.      rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive) **
  1158.  
  1159.      rb    [-abt+y] [dir] [file ...]     (YMODEM receive) **
  1160.  
  1161.      rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive) **
  1162.  
  1163.      rc    [-abt+y] file1                (XMODEM/CRC receive)
  1164.  
  1165.      ro    [-abt+y] file1                (XMODEM OverThruster receive)
  1166.  
  1167.      rx    [-abt+y] file1                (XMODEM receive)
  1168.  
  1169.      rx -g [-abt+y] file1                (Qmodem-G receive) **
  1170.  
  1171.            ** Download directory specification and -g ignored w/o
  1172.            registration
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.      Chapter 6 Pg 18        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1182.  
  1183.  
  1184.      sz    [-abefnprtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file ...(ZMODEM
  1185.            send)
  1186.  
  1187.      sz    [-abeEfmMnpPrtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file
  1188.            ...(ZMODEM-90 send)
  1189.  
  1190.            Pathnames are separated by spaces.  Wildcards are OK.
  1191.  
  1192.            EXAMPLE: gsz port 2 sz -r /tmp/file1 /tmp/file3 *.c
  1193.  
  1194.  
  1195.            The "sz" and "sb" commands exploit DOS's tree structured file
  1196.            system.  A directory or disk specifier expands to all files in
  1197.            that directory.
  1198.  
  1199.            EXAMPLE: gsz port 2 sz -r C:srcdir
  1200.  
  1201.  
  1202.            If you use PREFIX= or ONAME= with the "sb" or "sz" commands, these
  1203.            pathnames must be entered in lower case unless the underlying file
  1204.            system supports upper AND lower case.
  1205.  
  1206.            EXAMPLE: gsz port 2 sz -r ONAME=newsrc.c temp.c
  1207.  
  1208.  
  1209.  
  1210.      sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM or YMODEM-g send)
  1211.  
  1212.      sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k or YMODEM-g
  1213.            send)
  1214.  
  1215.      sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  1216.  
  1217.      sx -k [-t] file1                    (XMODEM-1k send)
  1218.  
  1219.  
  1220.      v     Verify the serial number by writing a log entry (see DSZLOG).
  1221.  
  1222.            v      1     0 bps    0 cps   0 errors     0  128 s/n 666
  1223.  
  1224.            The letter "v" indicates a verification entry.  The first numeric
  1225.            field is 1 if YMODEM-g is supported.  The last field is the serial
  1226.            number.  Unregistered copies show a s/n of 0.
  1227.  
  1228.  
  1229.      o     Turn off Data Terminal Ready (DTR), terminating ("offing") the
  1230.            connection if the modem responds to DTR.  Useful with the "t"
  1231.            command to disconnect afterwards.
  1232.  
  1233.            EXAMPLE: gsz t o
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      Chapter 6 Pg 19        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1241.  
  1242.  
  1243.      LARG  Convert ARG to lower case, then parse arg.
  1244.  
  1245.  
  1246.      The meanings of optional arguments to the file transfer commands are
  1247.      described in DSZBG.DOC and the ZCOMM/Pro-YAM manual.
  1248.  
  1249.      The s (SlugBait) option prevents a receiver from receiving a file
  1250.      without accounting for it.  Attempts to do so are flagged with a Q
  1251.      status in the log file.  This option can cause a transfer that
  1252.      legitimately fails near the end of the file to be reported as
  1253.      Questionable rather than ERROR.  SlugBait causes GSZ to return success
  1254.      if at least one file is transferred.
  1255.  
  1256.      Send files may be specified indirectly:
  1257.                                gsz sz @C:files.lst
  1258.      sends the files in C:files.lst.  This provides another means of
  1259.      bypassing the DOS command line limit.  The first letter must be "@" and
  1260.      the third letter must be ":" to distinguish this from an ordinary
  1261.      pathname.  Pathnames in the indirection file may be separated by any
  1262.      combination of space(s), tab(s), CR and/or LF.  No spaces may appear
  1263.      inside a pathname; "FOO     .BAR" won't work.
  1264.  
  1265.      A list of files to send may be built up with a command like:
  1266.  
  1267.      EXAMPLE: dir *.zip > files.tmp
  1268.  
  1269.      This file can be edited to remove unwanted files.  Then you send the
  1270.      files with:
  1271.      GSZ sz -m @c:files.tmp
  1272.  
  1273.  
  1274.      6.2  Interrupt Keys
  1275.  
  1276.      Ctrl-Break Terminates the transfer in progress.
  1277.  
  1278.      ALT-N Abruptly terminates (NUKES) the transfer in progress.
  1279.  
  1280.      Ctrl-X Typing a dozen Ctrl-X characters to another ZMODEM program
  1281.           terminates ZMODEM operations.
  1282.  
  1283.      ALT-F Skips the current file in ZMODEM transfers.
  1284.  
  1285.      ALT-B Cancels the current ZMODEM session.
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.      Chapter 7 Pg 20        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1300.  
  1301.  
  1302.      7.  NUMERIC PARAMETERS
  1303.  
  1304.      GSZ uses the following main numeric parameters, settable with the pxN
  1305.      command.
  1306.  
  1307.      EXAMPLE: gsz pQ0 rz -rr
  1308.  
  1309.  
  1310.      **************************************************************************
  1311.      NOTE: Parameter setting commands such as "pd0" cannot be added to
  1312.      DSZOPT, they must be included in the command line.
  1313.      **************************************************************************
  1314.  
  1315.      In addition, GSZ uses the Pro-YAM/ZCOMM zmodem numeric parameters
  1316.      described in the Pro-YAM/ZCOMM reference manual (ZCOMMDOC.ZIP) and in
  1317.      DSZBG.DOC.
  1318.  
  1319.  
  1320.      B   Set the size of buffer used for disk reads and writes.  The default
  1321.          is 1024, 4096 maximum (16384 max on GSZ and DSZ.EXE).  If your copy
  1322.          of GSZ is running on a floppy disk system or a very slow turkey hard
  1323.          disk, a larger value may give better results.  Too large a value may
  1324.          exhaust memory, induce receiver timeouts, cause disconnects(!), or
  1325.          generate spurious CRC errors.  If performance logging doesn't work,
  1326.          this parameter is too big.
  1327.  
  1328.          EXAMPLE: gsz pB4096 sz A:floppy.fil
  1329.  
  1330.          Setting the buffer size may lock out the performance log, DSZFILES,
  1331.          and/or indirect pathname list in GSZ.COM.
  1332.  
  1333.          IF YOU AREN'T BLOODY SURE YOU NEED A BIGGER BUFFER, DON'T USE ONE.
  1334.  
  1335.          Please understand that the B parameter has nothing to do with
  1336.          anything you've heard about 128, 1024 or 8192 byte XMODEM style
  1337.          blocks.  Normally, ZMODEM's block size is the entire file!
  1338.  
  1339.      G   This parameter controls the number of bytes loaded into the 16550A
  1340.          transmit FIFO (First In First Out) storage register on each
  1341.          interrupt.
  1342.  
  1343.          For maximum efficiency, GSZ fills the 16 byte transmit FIFO when the
  1344.          UART generates a FIFO Empty interrupt.  Once loaded, data
  1345.          transmission from the transmit FIFO cannot be stopped, so many bytes
  1346.          may be sent after the modem sends XOFF or asserts hard flow control
  1347.          restraint.  Good engineering practice requires that modems accept a
  1348.          large number of bytes after exerting flow control restraint, but
  1349.          some modems won't.
  1350.  
  1351.          This parameter is effective only with PCDOS machines using FIFO
  1352.          buffered UART devices.  To improve gsz's responsiveness to flow
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.      Chapter 7 Pg 21        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1359.  
  1360.  
  1361.          control restraint, set this parameter to 0.
  1362.  
  1363.          EXAMPLE: pG0
  1364.  
  1365.  
  1366.      O   This parameter controls XMODEM OverThruster(TM).  It is described in
  1367.          DSZBG.DOC.  This file is part of the software package sent to paid
  1368.          registrants.
  1369.  
  1370.      P   After a "speed" command, if you give a p command (display
  1371.          parameters), the P parameter value will indicate the type of serial
  1372.          I/O UART chip detected.  GSZ automatically detects and enables the
  1373.          FIFO on the NS16550A, NS16550AFN, and Intel 82510 chips.
  1374.  
  1375.          EXAMPLE: gsz port 1 speed 19200 p
  1376.  
  1377.  
  1378.          0  Indicates a standard 8250 or 16450 UART with no special features.
  1379.  
  1380.          1  Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO.
  1381.             These are the preferred chips.
  1382.  
  1383.          2  Indicates an Intel 82510 with 3 deep receive FIFO.
  1384.  
  1385.          The sequence "port 1 pP1 speed 19200" bypasses GSZ's verification
  1386.          checks normally performed on the FIFO configuration and may allow
  1387.          defective FIFO logic on certain chips to be used.  This incantation
  1388.          is not required for the NS16550AN or NS16550AFN.
  1389.  
  1390.          The sequence "pP-1 speed 2400" should be used with the Western
  1391.          Digital WD16550 chip to disable the brain damaged FIFO on that chip.
  1392.          The WD16550 FIFO has been observed to lose data when transmitting at
  1393.          2400 bps and slower speeds.  The minimum speed for normal transmit
  1394.          FIFO operation with the WD16C550 may vary with different computers.
  1395.  
  1396.  
  1397.      Q   Error code returned to DOS (default 1).  (Success always returns 0.)
  1398.          Some programs toss cookies when confronted with certain exit codes.
  1399.  
  1400.          EXAMPLE: gsz pQ-1 sz foo.bar
  1401.  
  1402.  
  1403.          GSZ reports an error if no files have been transferred, even if the
  1404.          command used wasn't supposed to transfer any file(s).
  1405.  
  1406.  
  1407.      R   If set to 1, causes partially received files to be deleted.
  1408.  
  1409.          EXAMPLE: GSZ pR1 rz
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.      Chapter 7 Pg 22        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1418.  
  1419.  
  1420.      S   Timeout in seconds (default 15) waiting for restraint release (XON
  1421.          and/or handshake).
  1422.  
  1423.      V   (DSZ.COM and GSZ only) Set this to 1 to use direct to screen video.
  1424.          This speeds up displays but may cause serial input errors when CGA
  1425.          equipped computers are used at high speeds.
  1426.  
  1427.          EXAMPLE: GSZ pV1 rz
  1428.  
  1429.          sets direct video output.
  1430.  
  1431.      W   Wait for Enter key before exiting after an error.  Effective only on
  1432.          registered copies.  Useful when calling GSZ from DESQview, allows
  1433.          the window to close unless there is an error message that should
  1434.          remain visible.
  1435.  
  1436.          EXAMPLE: gsz pW1 sz foo.bar
  1437.  
  1438.  
  1439.      Y   Control byte for the NS16550AN/NS16550FAN FCR register.  If you
  1440.          don't know what the FCR does, don't change this parameter.  It has
  1441.          been suggested that a different value (129) may improve multitasking
  1442.          under DESQview when multiple copies of GSZ are active.
  1443.  
  1444.      a   Calibrates certain protocol timeouts used with XMODEM and YMODEM
  1445.          transfers (Cybernetic Data Recovery(TM)).  This parameter does not
  1446.          affect ZMODEM transfers.
  1447.  
  1448.          The a numeric parameter is automatically set to 2000 for a 4.77 mHz
  1449.          PC or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for
  1450.          a PS2/80.  If your computer has a speedup card or otherwise runs
  1451.          unusually fast (or slow!) for its type, you may set the a numeric
  1452.          parameter to a value that reflects its speed.
  1453.  
  1454.          EXAMPLE: gsz port 2 pa4000 rb
  1455.  
  1456.  
  1457.          NOTE: Setting this parameter does not suppress the "Unknown Machine
  1458.          Type" message which is displayed before the command line is scanned.
  1459.  
  1460.      d   A non zero value (the default) causes incoming files received with
  1461.          ZMODEM and full YMODEM transfers to have their Date set to that sent
  1462.          in the file header.  ZMODEM's file management features depend on the
  1463.          transmission of each file's modification date.  Files will have the
  1464.          same creation date, even if the two machines are in different time
  1465.          zones.  When transferring files to/from a Unix system, creation
  1466.          dates are interpreted according to GMT or Universal Coordinated
  1467.          Time.  File dating may be disabled with a pd0 command, which causes
  1468.          files to assume the date and time they were received.
  1469.          NOTE: Backdating file creation times may confuse some backup
  1470.          programs.
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.      Chapter 7 Pg 23        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1477.  
  1478.  
  1479.      v   Verbose level (debugging output) Negative values inhibit some
  1480.          routine messages.  Setting v to 1 or greater causes serialized
  1481.          copies to ring the bell when a transfer is done.
  1482.  
  1483.          EXAMPLE: gsz pv1 port 2 rz
  1484.  
  1485.  
  1486.      z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  1487.          transfers to coordinate the actual date of the file with computers
  1488.          in other time zones.  Effective on registered copies.  PDT or MST
  1489.          corresponds to 420.  This may be preset with the ZONE DOS
  1490.          environment variable.
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.      Chapter 8 Pg 24        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1536.  
  1537.  
  1538.      8.  ENVIRONMENT VARIABLES
  1539.  
  1540.      The following DOS environment variables may be set to modify GSZ
  1541.      operation.  DOS environment variables are set by giving a command to DOS
  1542.      before running GSZ.  You can add these commands to your autoexec.bat
  1543.      file.
  1544.  
  1545.  
  1546.      EXAMPLE: set DSZPORT=2
  1547.  
  1548.  
  1549.      The following form may be used for arbitrary address/vector
  1550.      combinations:
  1551.  
  1552.      EXAMPLE: set DSZPORT=3e8,4
  1553.  
  1554.      These DOS "set" commands may be placed in your AUTOEXEC.BAT file or
  1555.      given just before you run your communications program.
  1556.  
  1557.      IMPORTANT! Do not add spaces to these commands!!
  1558.      set DSZPORT  =  2 WILL NOT WORK!
  1559.  
  1560.  
  1561.      DIRRX (Registered copies only.) Specifies the directory to receive
  1562.          (download) files.  If the sting in DIRRX ends with "/", directory
  1563.          and/or disk designators in the incoming pathname are stripped, and
  1564.          only the stem (name and extension) is used.  Otherwise, if an
  1565.          incoming file has an absolute pathname, the incoming pathname is
  1566.          used.
  1567.  
  1568.          EXAMPLE: set DIRRX=C:/modem/download/gsz/
  1569.          gsz rz -r
  1570.          downloads files to the /modem/download/gsz directory on the C:
  1571.          drive, with ZMODEM Crash Recovery..
  1572.  
  1573.  
  1574.          EXAMPLE: set DIRRX=B:/
  1575.  
  1576.          The DOS "set" command defining the receive directory may be placed
  1577.          in your AUTOEXEC.BAT file.  Make certain there is enough environment
  1578.          space to hold this value.  Confirm this by typing "set" to the DOS
  1579.          prompt and verifying the DIRRX value is listed correctly.
  1580.  
  1581.      DSZFILES May contain a list of up to 9999 pathnames to transmit, with
  1582.          entries separated by spaces.  If present, DSZFILES is used in place
  1583.          of a normal command line list of files to send with the sb and sz
  1584.          commands.
  1585.  
  1586.          EXAMPLE: set DSZFILES=file1 file2 file3 *.c
  1587.          gsz port 2 handshake on sz -rr
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.      Chapter 8 Pg 25        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1595.  
  1596.  
  1597.          In practice, this string would be built up by a calling program and
  1598.          passed to GSZ with a "spawnvpe", "execvpe", or similar subroutine
  1599.          call.
  1600.  
  1601.          SEE ALSO: Pathname list specification @C:files.lst
  1602.  
  1603.      DSZLOG log file to receive entries for files sent and received.
  1604.          (Default null).  Sample entries:
  1605.  
  1606.      Z  46532 38400 bps 3324 cps   0 errors    66 1024 GSZ.COM 1177
  1607.      Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  1608.  
  1609.          Transfer times are based on the DOS time of day clock and have up to
  1610.          two seconds' uncertainty.  As with all protocol throughput reports
  1611.          generated by Omen Technology programs (and contrary to the false
  1612.          claims of some critics), GSZ's throughput figures for ZMODEM,
  1613.          Kermit, and True YMODEM(TM) transfers do not take "credit" for
  1614.          pathname and/or protocol overhead characters.  GSZ's throughput
  1615.          reports do not include the time required to send the pathname.  This
  1616.          understates the true time required to transfer files, but the time
  1617.          required to send the pathname often depends on the alacrity of the
  1618.          operator, and thus does not always reflect the performance of the
  1619.          protocol itself.
  1620.  
  1621.          Transfers measuring less than one second are reported as having 9999
  1622.          characters per second throughput.
  1623.  
  1624.          The unlabeled numeric field after the error (retry) count is the
  1625.          number of flow control stoppages encountered sending the file.  This
  1626.          number gives an indication of flow control restrictions (overloaded
  1627.          networks, etc.) encountered during the transfer.
  1628.  
  1629.          The last numeric field before the file name is the YMODEM block size
  1630.          or ZMODEM subpacket length used for the last block in the file.
  1631.  
  1632.          The last field is the serial number of the other program, or -1 if
  1633.          this information is not available.  When sending files, the
  1634.          receiving program's serial number is not normally available unless
  1635.          the -S option is used.
  1636.  
  1637.          The code letter indicates the type of transfer, Z (ZMODEM), S
  1638.          (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by
  1639.          loss of data carrier).
  1640.  
  1641.          WARNING: If GSZ encounters a loss of carrier or other fatal error
  1642.          condition before a file COMMENCES transmission, a log entry may not
  1643.          be made.
  1644.  
  1645.  
  1646.          EXAMPLE: set DSZLOG=C:/yam/gszlog
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.      Chapter 8 Pg 26        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1654.  
  1655.  
  1656.          IMPORTANT! NO SPACES!!
  1657.  
  1658.  
  1659.      DSZOPT (Registered copies only) String containing default options for
  1660.          GSZ file transfers.  Legal option letters for DSZOPT are the
  1661.          optional modifiers to the GSZ sz, rz, sx, rx, sb, rb commands.
  1662.  
  1663.          A T may be appended to the string to force GSZ to exit after it has
  1664.          recognized a ZMODEM AutoDownload(TM) request.
  1665.  
  1666.          An 8g may be appended to the string to make BBS (ANSI) graphics the
  1667.          default for GSZ's t command.  The ability to preset these options is
  1668.          especially helpful for controlling ZMODEM automatic downloads from
  1669.          GSZ's t command.
  1670.  
  1671.          EXAMPLE: set DSZOPT=r
  1672.          Enables GSZ's Intelligent Crash Recovery(TM) as a default.
  1673.  
  1674.          Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the
  1675.          GSZ term function:
  1676.          set DSZOPT=r8g
  1677.  
  1678.  
  1679.          If you're downloading files from GEnie with an MNP modem, the
  1680.          following will speed up your downloads with Genie's ZMODEM-90Tm.
  1681.          (You can recognize ZMODEM-90 on GEnie two ways: 1) MobyTurboTm is
  1682.          used to speed ZIP and ARC downloads, 2) "sz 4.xx" is displayed at
  1683.          the end of transfer.  As of this writing, ZMODEM-90 may not be
  1684.          available in all libraries.) Note that (as usual with GSZ) case is
  1685.          significant: the "r" must be lower case, the "W" upper case.
  1686.          set DSZOPT=rW16384
  1687.  
  1688.  
  1689.          WARNING: Do NOT include "ena" or any other commands in the DSZOPT
  1690.          string.  With the exception of the "8g" mode, only **options** may
  1691.          be placed in the DSZOPT string!  (Options are the letters that
  1692.          modify the sz, rz, sb, etc. commands.  In "rz -r", "r" is an
  1693.          option.)
  1694.  
  1695.          Parameters can not be set in DSZOPT.
  1696.  
  1697.      MAXBYTES Maximum number of bytes allowed for transfer.  If this number
  1698.          is exceeded, GSZ skips the offending files (ZMODEM) or aborts
  1699.          remaining files in the batch (YMODEM).
  1700.  
  1701.      DSZPORT Default communications port override, default 1.
  1702.  
  1703.          EXAMPLE: set DSZPORT=2
  1704.  
  1705.          IMPORTANT! NO SPACES!!
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.      Chapter 8 Pg 27        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1713.  
  1714.  
  1715.      ZONE sets the z numeric parameter to the number of minutes the current
  1716.          local time lags GMT time.  PDT or MST corresponds to 420.  PST
  1717.          corresponds to 480.
  1718.          EXAMPLE:
  1719.          set ZONE=420
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.      Chapter 9 Pg 28        GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1772.  
  1773.  
  1774.      9.  EXIT STATUS
  1775.  
  1776.      GSZ exits with 0 status for successful transfers, or the value of the Q
  1777.      numeric parameter (default 1) if a file transfer failed, or if no files
  1778.      were transferred.  Many languages and "door" programs do not return this
  1779.      information to the calling program.  Some languages and "door" programs
  1780.      freak out (hang) on certain non-zero exit values.
  1781.  
  1782.      A batch file that calls GSZ directly may be used to detect the GSZ exit
  1783.      status with the DOS "errorlevel" construct.  Please refer to the Q
  1784.      numeric parameter below for more information.
  1785.  
  1786.      GSZ's log file entries may also be examined to determine the success or
  1787.      failure of a file transfer.
  1788.  
  1789.      GSZ commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.
  1790.      The file transfer commands are fully described in ZCOMMDOC.ZIP, the
  1791.      ZCOMM User's Manual.  Relevant portions of the ZCOMM User's Manual are
  1792.      provided in DSZBG.ZOO, a Copyrighted file included with the GSZ
  1793.      registration disk.  You may refer to one of those documents for details
  1794.      on the following commands.
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.      Chapter 10 Pg 29       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1831.  
  1832.  
  1833.      10.  EXAMPLES
  1834.  
  1835.      gsz sz c:foo.zip              (send 1 file with ZMODEM)
  1836.  
  1837.      gsz sz -m c:*.zip             (send all .ZIP files with MobyTurbo(TM))
  1838.  
  1839.      gsz sz f1.c f2.c f3.c         (send 3 files with ZMODEM)
  1840.  
  1841.      gsz sz c:foo.* b:*.c          (send multiple files with ZMODEM)
  1842.  
  1843.      gsz sz -Z *.lst               (send text files with ZMODEM compression)
  1844.  
  1845.      gsz sz -r bigone.zip          (CRASH RECOVERY: resume interrupted
  1846.      transfer)
  1847.  
  1848.      gsz rz -r                     (CRASH RECOVERY: resume interrupted
  1849.      transfer)
  1850.  
  1851.      gsz rz -rr                    (CRASH RECOVERY with file comparison)
  1852.  
  1853.      gsz handshake both sz yamdemo.zip       (Hardware+Software handshake)
  1854.  
  1855.      gsz sz -n *.*                 (send files that are newer or rx has no
  1856.      copy)
  1857.  
  1858.      gsz sz -Yn *.*                (Only send files that are newer than
  1859.      receiver's copy)
  1860.                                    (Do not send files that do not exist on
  1861.      receiver's disk)
  1862.  
  1863.      gsz rz C:/UPLOADS             (receive files to specified directory #)
  1864.  
  1865.      gsz port 2 speed 38400 handshake both restrict rz
  1866.                                    (Restrict provides protection for BBS's)
  1867.  
  1868.      gsz rz  -y prog.zip           (ZMODEM, single file pathname override)
  1869.  
  1870.      gsz z pr1 rx foo.dat          (XMODEM receive, remove file if error)
  1871.  
  1872.      gsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP #)
  1873.  
  1874.      GSZ LRC L-Y NEWPROG.ZIP       (generate lower case "rc -y" command)
  1875.  
  1876.      gsz sz foo >debug.dmp         (Debugging data dump)
  1877.  
  1878.      gsz sz @C:/bbs/files.lst      (Indirect file list)
  1879.  
  1880.      gsz sz -u *.lst               (Unlink (Delete) files as they are sent)
  1881.  
  1882.      # Registered copies only
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.      Chapter 10 Pg 30       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1890.  
  1891.  
  1892.      11.  BACKGROUND OPERATION
  1893.  
  1894.      Three DESQview description files are provided to demonstrate background
  1895.      operation with modest (66 kb window) memory requirements.  DSZ uses
  1896.      tight C/ASM code, table driven CRC generators, and buffered receive and
  1897.      transmit for good performance in the background without hogging CPU
  1898.      cycles.  On a QIC Labs 8 mHz PC-AT clone, DSZ can download files in the
  1899.      background (3 background clock ticks, 9 foreground clock ticks) with a
  1900.      throughput better than 9600 bps.
  1901.  
  1902.      GSZ operates under DESQview with 128k of memory.
  1903.  
  1904.      2S   Prompts for file name(s) and sends them with ZMODEM protocol.
  1905.           File: 2S-PIF.DVP
  1906.  
  1907.      2T   Talks to the modem and allows manual YMODEM (F3) or automatic
  1908.           ZMODEM downloads.  File: 2T-PIF.DVP
  1909.  
  1910.      2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI
  1911.           CRT device driver to process ANSI screen codes.  File: 2A-PIF.DVP
  1912.           DS.BAT is the batch file used by 2A.
  1913.  
  1914.      These files are written for a port 2 local connection and \TMP
  1915.      directory, but may be modified to suit your requirements using the
  1916.      DESQview CP command.  The W numeric allows DESQview to close the window
  1917.      after DSZ finishes, providing a pleasant user interface.
  1918.  
  1919.      Other DVPs, Scripts, and Batch files are available on the DESQView
  1920.      conference on the Sound of Music as DVDSZ20Z.ARC.
  1921.  
  1922.      Please consult the DESQview documentation for instructions on
  1923.      installation procedure for the DVP files.
  1924.  
  1925.      Operation at high speed (above 9600 bps) may require the DESQview
  1926.      "Optimize communications" performance Advanced Setup option.
  1927.  
  1928.      Newer versions of DESQview may require more "common memory" allocation
  1929.      (6-8 k bytes) to operate with DSZ.  Some versions of DESQview do not
  1930.      operate properly with DSZ; DESQview 2.0 is known to work, and DESQview
  1931.      2.25 is reported to have fixed bugs in intermediate versions.
  1932.  
  1933.      On 286 and 386 machines, some DESQview operations involve swapping
  1934.      memory contents with buffers in extended memory.  As with extended
  1935.      memory ramdisks and disk caches, this causes errors with high speed
  1936.      communications.  The considerations discussed in the "286 and 386
  1937.      Extended Memory" subchapter apply here.  Since this DESQview extended
  1938.      memory swapping is asynchronous with respect to DSZ's file transfers,
  1939.      "handshake slow" doesn't help here.  The solution is to force DESQview's
  1940.      memory swaps to use smaller blocks (with interrupts allowed between
  1941.      blocks) and/or use NS16550AN or NS16550AFN chips for the serial
  1942.      interface.
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.      Chapter 11 Pg 31       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  1949.  
  1950.  
  1951.      If you see funny characters on the screen while a program is loading,
  1952.      you have a conflict between the display adapter and QEMM memory manager
  1953.      which may cause lockups.  If so you must explicitly exclude the display
  1954.      adapter's memory with an EXCLUDE clause in QEMM's config.sys entry.
  1955.  
  1956.            ***********************************************************
  1957.                                      WARNING
  1958.      When running GSZ under a multi tasking system such as DESQview, do not
  1959.      allow two programs to access the same comm port at the same time.  At
  1960.      best, such actions will disrupt communications.  At worst, your computer
  1961.      will attempt to open a subspace channel to V'ger.
  1962.  
  1963.      Tell DESQview to use the SPECIFIC port number you are using, and not "Y"
  1964.      to the question: "Uses serial Ports (Y, N, 1, 2)"
  1965.  
  1966.      When running a comm program under DESQview or any related multitasking
  1967.      executive, GSZ must be called directly from the comm program, in the
  1968.      same window.  DO NOT open a separate window for DSZ unless you were
  1969.      about to power down the computer anyway.
  1970.            ***********************************************************
  1971.  
  1972.      With some communications programs, you can make the call, log in, and
  1973.      then exit (closing the window) without disconnecting the modem.  At this
  1974.      time you can fire up DSZ with the "t" command to allow YMODEM or ZMODEM
  1975.      downloads in a small window.
  1976.      Example File: 2A-PIF.DVP
  1977.  
  1978.      Alternatively, you can start DSZ from the DOS prompt, then type "AT"
  1979.      commands to the modem to call the bulletin board.  DESQview's "learn"
  1980.      facility may be helpful here.
  1981.  
  1982.      11.1  Windows 3
  1983.  
  1984.      Communications programs do not operate well under Windows 3 because
  1985.      Windows does not have true multitasking.
  1986.  
  1987.      11.2  VM
  1988.  
  1989.      According to Marshall Sutherland, Be sure to set IOPL3 mode to YES.
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.      Chapter 12 Pg 32       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2008.  
  2009.  
  2010.      12.  FLOW CONTROL
  2011.  
  2012.      If you plan to send files over Telenet (PC-Pursuit), you must refer to
  2013.      the Pro-YAM or ZCOMM Reference manual (in ZCOMMDOC.ZIP) FLOW CONTROL
  2014.      chapter for vital information on flow control considerations necessary
  2015.      for proper operation of ZMODEM and other streaming protocols.
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.      Chapter 13 Pg 33       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2067.  
  2068.  
  2069.      13.  ERROR MESSAGES
  2070.  
  2071.      COM2 1200 bps Carrier Detect enabled Handshake slow
  2072.      Command line = (commands)
  2073.      This is a normal message displayed to help resolve problems with
  2074.      incorrect batch files.  The port number, speed, carrier detect
  2075.      ("enabled" or "DISABLED") and "handshake" indicate the selected mode of
  2076.      operation.
  2077.  
  2078.      GSZ FINISHED! exit code = 0
  2079.      This is GSZ's normal exit when at least one file has been transferred
  2080.      and no unrecoverable errors have been detected.  If an error such as a
  2081.      failed file transfer had been detected, the exit code would be 1, or the
  2082.      value set in the Q numeric parameter.
  2083.  
  2084.      As the message implies, GSZ has done all of its processing, and has
  2085.      return the communications port and vector to its original value before
  2086.      displaying this message.  If the computer locks up after this message is
  2087.      displayed, there's something wrong with the program that called GSZ, not
  2088.      with GSZ itself.
  2089.  
  2090.      Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM
  2091.      BIOS that does not follow the IBM specification for identifying the
  2092.      machine type.  If your computer causes GSZ to display this message, you
  2093.      may set the a numeric parameter described elsewhere in this document.
  2094.      This message is generated before any commands are read, so do not be
  2095.      alarmed when you "discover" that setting the a parameter doesn't make
  2096.      this message go away.  The a parameter does not affect ZMODEM transfers.
  2097.  
  2098.      Please send us a postcard or letter indicating the reported hex value
  2099.      for machine Type, name of the computer, and its speed so we can include
  2100.      that machine type in a future release.
  2101.  
  2102.      Need more memory to run GSZ or Abnormal program termination is displayed
  2103.      by the TurboC startup routine if GSZ is run in too small a memory
  2104.      partition.  If you see this message, use a larger memory partition for
  2105.      GSZ or remove some memory resident programs.  This message may also
  2106.      appear if the calling program fails to free memory before calling GSZ.
  2107.  
  2108.      No Carrier Detect is displayed when GSZ recognizes a lack of carrier
  2109.      detect signal from the modem.  Most support calls concerning "No Carrier
  2110.      Detect" are caused by the user failing to tell GSZ to use the correct
  2111.      port.  GSZ does not magically divine the COM port number; if the default
  2112.      COM1 is incorrect, GSZ must be told what port to use with the port
  2113.      command or the DPORT environment variable.
  2114.  
  2115.      No Carrier Detect may also be caused by a line disconnect, defective
  2116.      cable, or incorrect modem strapping.  It may be disabled with the d
  2117.      command.  Sometimes this is caused by setting the B parameter to too
  2118.      large a value.
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.      Chapter 13 Pg 34       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2126.  
  2127.  
  2128.      Garbage Count Exceeded Indicates ZMODEM has not detected a valid start
  2129.      of header in a reasonable number of characters.
  2130.  
  2131.      If GSZ becomes "stuck" on emitting this messages, it is possible the
  2132.      sending program may not be able to recognize and act upon transmission
  2133.      requests (ZROPS headers).  The sending program should be corrected.  In
  2134.      the meantime, setting a ZMODEM packet length with the "zmodem pl4096"
  2135.      ("l" is the small letter l) command will force the sender to wait for
  2136.      the receivers' progress reports.
  2137.  
  2138.      Permission denied comes from the Microsoft C Library.  This is caused by
  2139.      attempts to modify a read only file or directory, or to create a file in
  2140.      a nonexistent directory.
  2141.  
  2142.      A furtive flashing appearance of XOFF or FLOW during ZMODEM or YMODEM-g
  2143.      file sending signifies GSZ is responding to flow control restraint.
  2144.      This is normal operation when buffered modems or packet switched
  2145.      networks are used.  ZMODEM's robustness and reliability allow creative
  2146.      users to transfer files over unusual multiple computer lash-ups, causing
  2147.      modem data lights and computer status displays to dance in unfamiliar
  2148.      rhythms.
  2149.  
  2150.      Output FLow Control Restraint RELEASED Indcates GSZ has not received a
  2151.      positive flow control signal (XON and/or CTS as specified by the
  2152.      handshake command) within the timeout specified by the S numeric
  2153.      parameter.  This message may appear as the result of line noise.  If it
  2154.      appears often, it may indicate improper flow control settings, defective
  2155.      modem and/or cable, or (rarely) too small a value for the S numeric
  2156.      parameter.  A TSR program that monitors ring detect has also caused this
  2157.      problem.
  2158.  
  2159.      Not allowed to overwrite %s By default, GSZ will not overwrite an
  2160.      existing file.  Use the -y or -n or -r option to overwrite/update
  2161.      existing files.
  2162.  
  2163.  
  2164.      13.1  Got ZRPOS
  2165.  
  2166.      Got ZRPOS indicates the receiving program has detected a transmission
  2167.      error and has requested retransmission.  In other words, ZMODEM is doing
  2168.      its job of detecting and correcting missing and garbled data.
  2169.  
  2170.      If this happens with error correcting modems, or more often than
  2171.      observed line noise would suggest, the receiver's error messages must be
  2172.      studied.  "Line Status Register 01" messages indicate a flow control
  2173.      problem.  "Line Status Register 02" messages suggest a receiver problem
  2174.      with interrupt latency.
  2175.  
  2176.      Otherwise, the sender may have a flow control problem in one of four
  2177.      areas:
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.      Chapter 13 Pg 35       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2185.  
  2186.  
  2187.        + Between the sending program and its modem.  If using an interface
  2188.          speed higher than the transmission speed, or modem to modem error
  2189.          correction (MNP, LAPB, PEP, etc.), check that the modem and the
  2190.          sending program are configured for the same flow control methods.
  2191.          Omen Technology's software is faster than most other programs, and
  2192.          may expose flow control problems not seen with slower software.
  2193.  
  2194.        + Between the sending modem and the network.  Correcting this requires
  2195.          "handshake both" to allow the sending program to honor both hardware
  2196.          (CTS) flow control from the modem and software flow control
  2197.          (XON/XOFF) from the network.
  2198.  
  2199.        + Between parts of the network.
  2200.  
  2201.        + Between the receiving modem and the receiving program.  This can
  2202.          happen at high transmission speeds when the receiver has specified a
  2203.          large I/O buffer size with the B numeric parameter.
  2204.  
  2205.          Excessive interrupt latency from extended memory ramdisks or disk
  2206.          caches, and poorly written hard disk drivers also wreak havoc on
  2207.          streaming protocols but do not affect start-stop protocols (XMODEM,
  2208.          etc.).  Problems with extended memory disk caches may cause errors
  2209.          at regular intervals; check the receiver's error messages.
  2210.  
  2211.          To work around these problems, give the "handshake slow" command to
  2212.          the receiver.
  2213.  
  2214.      13.2  Subpacket too Long
  2215.  
  2216.      This error may be caused by flow control problems at the sender (see
  2217.      above).
  2218.  
  2219.      13.3  Bad CRC
  2220.  
  2221.      This error may be caused by flow control problems at the sender (see
  2222.      above).
  2223.  
  2224.      Byte NNNN retry M: <error message> These messages appear when the
  2225.      protocol has detected an error and is attempting to retransmit the
  2226.      garbled data.  These are normal messages.
  2227.  
  2228.  
  2229.      13.4  Serial Input Error: Line Status Register xx
  2230.  
  2231.      Serial Input Error: Line Status Register HH indicates a hardware
  2232.      problem, slow device driver, TSR program, or other software is disabling
  2233.      interrupts too long for the program to accept incoming data, and some
  2234.      characters are lost.  A slow response to folow control also triggers
  2235.      this message.
  2236.  
  2237.      The value of the line status register is displayed in HEX.  The
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.      Chapter 13 Pg 36       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2244.  
  2245.  
  2246.      following error conditions are OR'ed into the Line Status Register.
  2247.  
  2248.  
  2249.      01   The Interrupt level circular buffer has been overrun.  This
  2250.           indicates a flow control problem.  The remote did not respond to
  2251.           GSZ's XOFF or hardware flow control signal, and continued to send
  2252.           characters after being told not to.  This problem is alleviated by
  2253.           matching flow control between the sending computer, modems, and the
  2254.           receiving computer.  Usually, the mismatch exists between the
  2255.           sending computer and its modem.
  2256.  
  2257.  
  2258.      02   An 02 value for the LSR indicates Data Overrun.  "Data Overrun"
  2259.           means the computer was not able to respond to an incoming character
  2260.           from the UART (modem) in time to make room for the next incoming
  2261.           character.  Data Overruns are caused by poorly designed software
  2262.           (or ROM BIOS "firmware") locking out interrupts for excessive
  2263.           periods.  These lockouts prevent the communications program from
  2264.           responding to the incoming characters quickly enough.
  2265.  
  2266.           To correct Data Overruns, you must correct the offending
  2267.           condition(s) to allow the communications program to operate
  2268.           properly.
  2269.  
  2270.           Common causes of excessively long interrupt lockouts ("critical
  2271.           code regions") are disk drivers (BIOS), window managers (Windows 3
  2272.           is terrible), disk caches, TSR programs, and EGA/VGA board auto-
  2273.           select.
  2274.  
  2275.           Slowing the CPU to allow games and other time dependent programs to
  2276.           be used can generate excessive interrupt latency.
  2277.  
  2278.           Some BIOS programs are written without regard to their effect on
  2279.           high speed communications.  Better versions of the offending BIOS
  2280.           programs may be made available if enough users complain about poor
  2281.           performance.
  2282.  
  2283.           Interrupt latency caused by EGA/VGA board auto-select can be often
  2284.           corrected by disabling the board's Auto-Select.
  2285.  
  2286.           Poorly written disk caches and disk drivers cause interrupt latency
  2287.           that affects streaming protocols (ZMODEM) but not start-stop
  2288.           protocols such as XMODEM, YMODEM, JMODEM, Lynx, etc.  The handshake
  2289.           slow command can be used to stop reception during disk transfers.
  2290.  
  2291.           Other chapters in this document give suggestions for working around
  2292.           excessive interrupt latency by using the NS16550AN UART chip.
  2293.           Please refer to the "Brain Damaged UARTS" subchapter.
  2294.  
  2295.           Please try all the suggestions mentioned here before contacting
  2296.           Omen Technology about data overruns.
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.      Chapter 13 Pg 37       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2303.  
  2304.  
  2305.      08   Framing Error generally caused by line noise or an incorrect
  2306.           transmission speed ("baud rate") or format (number of bits).  Also
  2307.           caused by some cheap internal modems.  Most protocols require 8
  2308.           bits no parity (-8n) for proper operation.  This is set
  2309.           automatically by Omen Technology programs, but other programs may
  2310.           not be so smart.
  2311.  
  2312.  
  2313.      10   Break Interrupt generally caused by line noise or an incorrect
  2314.           transmission speed ("baud rate") or format (number of bits).  Also
  2315.           caused by some cheap internal modems.
  2316.  
  2317.  
  2318.      18   Framing Error and Break Interrupt (see above) in combination.
  2319.  
  2320.           This error may also be caused by defective 8250 UART chips.  Some
  2321.           internal modem cards have slow 8250 chips that do not operate
  2322.           properly with computers faster than 4.77 mHz.  Replacing the 8250
  2323.           with a NS16550AN is recommended.  Please refer to the "Brain
  2324.           Damaged UARTS" subchapter for details.
  2325.  
  2326.      Please refer to the In Case of Difficulty chapter of this document for
  2327.      solutions.
  2328.  
  2329.      Less commonly encountered GSZ error messages are explained in the Pro-
  2330.      YAM manual.
  2331.  
  2332.  
  2333.      13.5  No Carrier Detect
  2334.  
  2335.      If you see a No Carrier Detect message, and you haven't lost the
  2336.      connection, you should fix your modem cable or modem settings to allow
  2337.      proper operation of the Carrier Detect signal (CD).
  2338.  
  2339.      A poorer alternative is to give the d command:  gsz port 1 speed 2400 d
  2340.      t
  2341.  
  2342.  
  2343.      13.6  Port %d (%X) defective
  2344.  
  2345.      When GSZ selects a serial port, it performs a quick hardware check to
  2346.      verify the presence and minimal functionality of the 8250 family UART.
  2347.      This message usually means a nonexistent port has been selected.
  2348.  
  2349.      Reports have been received of functional but nonstandard UART chips
  2350.      triggering this message.
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.      Chapter 13 Pg 38       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2362.  
  2363.  
  2364.      13.7  COMMAND NOT FOUND
  2365.  
  2366.      If you see this message, make sure GSZ is in the DOS PATH.  Sometimes
  2367.      this error is caused by having too many environment variable strings.
  2368.  
  2369.  
  2370.      13.8  Out of Environment
  2371.  
  2372.      means there is not enough room in the program environment to accept more
  2373.      data.
  2374.  
  2375.      DOS prints this message when it cannot allocate more memory to
  2376.      accommodate a "set" command, such as "set dirrx=c:/downloads/".
  2377.  
  2378.      Try moving the "set" commands to the batch file that calls your comms
  2379.      program, or to your AUTOEXEC.BAT file.
  2380.  
  2381.      To increase environment, use the /E switch. The default is 160 bytes.
  2382.  
  2383.      An example for your CONFIG.SIS file: SHELL=C:COMMAND.COM/E:256
  2384.  
  2385.      NOTE: Large environments may cause GSZ.COM to lockup.  This is less of a
  2386.      problem with GSZ.EXE.
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.      Chapter 14 Pg 39       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2421.  
  2422.  
  2423.      14.  SLOW TRANSFERS
  2424.  
  2425.      Some users report slower than expected file transfers even when few or
  2426.      no errors are reported.  Some possible causes are:
  2427.  
  2428.      If "handshake slow" is used, throughput may suffer.  Try one of the
  2429.      other solutions to the "Line Status Register = 02" errors discussed
  2430.      above.  When using "handshake slow" it may be possible to increase the
  2431.      modem's interface speed to 19200 bps or faster.
  2432.  
  2433.      Bad phone lines will silently slow MNP modems, sometimes without any
  2434.      error indications.  If the modems disconnect fairly often you should
  2435.      suspect marginal phone line conditions that are being hidden by MNP
  2436.      error correction.
  2437.  
  2438.      One of the programs may have set a parameter or option that acts to slow
  2439.      the transfer under certain conditions.
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.      Chapter 15 Pg 40       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2480.  
  2481.  
  2482.      15.  IN CASE OF DIFFICULTY
  2483.  
  2484.      15.1  LOCKUPS
  2485.  
  2486.      15.1.1  Insufficient Memory
  2487.      GSZ complains when it detects insufficient memory to operate.  When
  2488.      calling GSZ from another program, there may be ALMOST enough memory for
  2489.      proper operation, but GSZ locks up during a transfer or the calling
  2490.      program freezes after GSZ displays the "GSZ Finished" message.
  2491.  
  2492.      Sometimes there is a message about insufficient memory, sometimes just a
  2493.      lockup and no message.  To verify this problem, call CHKDSK from within
  2494.      your comms program (not from DOS!) by defining it as an external
  2495.      protocol.  If you use an interface program (Hotkeyz, Prodoor, etc.), you
  2496.      must call CHKDSK from that program, as those programs also reduce the
  2497.      memory available to GSZ.
  2498.  
  2499.      CHKDSK should report at least 64k free memory.  If less memory is
  2500.      reported, reduce the size of the COMMS program's capture buffer, or
  2501.      reboot the system with fewer/smaller device drivers and TSR programs.
  2502.      Calling GSZ directly from the comms program instead of from an interface
  2503.      also saves memory.
  2504.  
  2505.  
  2506.      15.1.2  Environment TOO BIG
  2507.      A large environment may cause GSZ.COM to lockup.  The size of the
  2508.      environment (the amount of text you get when you give the DOS "set"
  2509.      command) is subtracted from the data space available to 8086 C programs.
  2510.      This can be a problem with GSZ.COM, whose 8086 tiny model limits code,
  2511.      data, stack, and environment to 64 kb TOTAL.  Use GSZ.EXE (compiled with
  2512.      8086 small model) to alleviate this problem.
  2513.  
  2514.  
  2515.      15.1.3  Bad COM Port Configuration
  2516.      GSZ is fastidious about which interrupt vectors it takes over.  Unlike
  2517.      some programs, GSZ uses only the correct interrupt vector for its
  2518.      interrupt service routine.  (This allows multitasking.)
  2519.  
  2520.      GSZ obtains and releases this vector with standard DOS function calls.
  2521.      This allows multi line operation under DESQview and other multitasking
  2522.      systems.
  2523.  
  2524.      Incorrectly configured serial ports that work with programs that pig out
  2525.      both IRQ3 and IRQ4 will lock up with GSZ.  If GSZ locks up the machine
  2526.      as soon as it tries to send or receive data, this is usually the fault.
  2527.      Make sure the comm port is strapped correctly; COM1 uses IRQ4, COM2 uses
  2528.      IRQ3.  GSZ will lock up if the comm port is not properly set up.
  2529.  
  2530.      In addition, GSZ will not work properly if two devices are connected to
  2531.      the same IRQ line, even when some other programs (that don't use
  2532.      interrupts as intensively) do work normally on the same machine.
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.      Chapter 15 Pg 41       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2539.  
  2540.  
  2541.      COM3 and above are not widely standardized.  If you have problems with
  2542.      COM3, chances are your "COM3" is non standard.
  2543.  
  2544.  
  2545.      15.1.4  LAN Manager Conflicts
  2546.      Some Local Area Network (LAN) managers take over comm ports using code
  2547.      that interferes with GSZ.
  2548.  
  2549.      The following hint is from Tom Louvaris, LANtastic Sales/Support - New
  2550.      York.  Other LAN mamagers may require similar incantations to keep the
  2551.      LAN manager from messing with GSZ's comm port.
  2552.  
  2553.      Problem: When the lan is running, GSZ intermittantly fails.  GSZ starts
  2554.      the transfer by displaying "Ready to send pathname".  The receiving
  2555.      system does noting.  Eventually, GSZ exits with code 1, and no file is
  2556.      sent.
  2557.  
  2558.      To release one or more Com Ports with LANtastic 3.x, enter the
  2559.      following...
  2560.  
  2561.              Net Queue Halt \Sever-name Comn
  2562.  
  2563.  
  2564.      Note: You must be logged on to "Server-name" with Queue priveleges to
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.      Chapter 15 Pg 42       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2598.  
  2599.  
  2600.      enable the operation of this command.
  2601.  
  2602.      15.2  Incorrect Batch Files
  2603.  
  2604.      Incorrect batch files are the number one source of problems using GSZ
  2605.      for uploads and downloads.  Bulletin board programs with convoluted
  2606.      batch file mechanisms exacerbate the problem.
  2607.  
  2608.      GSZ's command line echo was added to assist in correcting defective
  2609.      batch files.  You should see a display like:
  2610.  
  2611.      Command line = 'rz '
  2612.      or
  2613.      Command line = 'port 2 speed 9600 sz foo.baz '
  2614.  
  2615.      You may have to add a "pause" command at the end of the batch file to
  2616.      allow GSZ's messages to be seen.  Another possibility is to turn on the
  2617.      printer with ^P before running GSZ, so GSZ's message can be saved on
  2618.      paper.
  2619.  
  2620.      In general, the Command line display should look like one of the
  2621.      examples in this document or those displayed by GSZ itself.  (The
  2622.      Command line display does not include the name of the GSZ program
  2623.      itself.)
  2624.  
  2625.      Try running GSZ by itself, without any batch files or TSR programs,
  2626.      calling it directly from DOS as described above.
  2627.  
  2628.  
  2629.      15.3  Cheap Internal Modems
  2630.  
  2631.      Numerous trouble reports have been received lately caused by cheap
  2632.      internal modems causing errors on ZMODEM transfers but not XMODEM.  A
  2633.      similar problem was experienced in the mid 80's during beta testing of
  2634.      some 2400 bps modems.  Perhaps defective LSI chips left over from those
  2635.      days were cloned or recovered from the trash bin.
  2636.  
  2637.  
  2638.      15.4  Commands Entered in Upper Case
  2639.  
  2640.      Most GSZ commands and options must be entered in lower case (small
  2641.      letters, not big letters).  Where the documentation or help screen
  2642.      indicates "rz", you must use "rz" and not "RZ".
  2643.  
  2644.  
  2645.      15.5  No Carrier Detect
  2646.  
  2647.      If you see a No Carrier Detect message, and you haven't lost the
  2648.      connection, you should fix your modem cable or modem settings to allow
  2649.      proper operation of the Carrier Detect signal (CD).
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.      Chapter 15 Pg 43       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2657.  
  2658.  
  2659.      A poorer alternative is to give the d command:  gsz port 1 speed 2400 d
  2660.      t
  2661.  
  2662.  
  2663.  
  2664.      15.6  PKARC 3.6
  2665.  
  2666.      It has been reported that PK36 grabs some interrupts and doesn't restore
  2667.      them on exit in an attempt to prevent hacks of the program.  Since
  2668.      eliminating that particular version and cleaning up memory, high speed
  2669.      transfers even with 8250 UARTS work properly again.
  2670.  
  2671.      The problem with PK 3.6 appears to be most severe if a BBS operator has
  2672.      doorware, etc that accesses the PK programs from a shell of some sort.
  2673.      This info may be helpful to users who are having otherwise inexplicable
  2674.      file transfer problems.
  2675.  
  2676.      Phil Katz has written me that this problem has been corrected in
  2677.      subsequent versions.
  2678.  
  2679.  
  2680.      15.7  DOS 3.x
  2681.  
  2682.      DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS
  2683.      to prevent antisocial behavior. This is required on the NEC Multispeed,
  2684.      or if certain TSR's are used.
  2685.  
  2686.  
  2687.      15.8  Perstor Controllers
  2688.  
  2689.      Several reports have been received indicating Perstor disk controllers
  2690.      interfere with data communications.  Perstor is reportedly working on a
  2691.      fix.
  2692.  
  2693.  
  2694.      15.9  IBM PS/2 Model 50Z
  2695.  
  2696.      Early samples of this machine have a design error on the motherboard
  2697.      that causes comms programs to lock up the machine.  Replacing the
  2698.      motherboard with a correctly functioning unit from current production
  2699.      corrects the problem.  The part number of the replacement PS2/50 Z
  2700.      motherboard is 35F5928.  (Information provided by John M. Choma
  2701.      73047,3566) U.S. IBM has stonewalled on this issue, but in December 1988
  2702.      agreed to replace the defective motherboards under warranty.
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.      Chapter 15 Pg 44       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2716.  
  2717.  
  2718.      15.10  Brain Damaged UARTS
  2719.  
  2720.      Omen Technology has received reports of problems with buggy 8250 type
  2721.      UART integrated circuits in Leading Edge modem boards, serial port
  2722.      interfaces, and computers.  The defective chip logic affects high
  2723.      performance software.  Replacing the buggy chip with a newer chip
  2724.      (NS16550AN) corrects the problem.
  2725.  
  2726.      The UM82450 chip in the Zoom 2400HC also appears to cause problems.
  2727.      Zoom Telephonics advises that this problem is limited to their old
  2728.      model.  The old model is inentifiable by an external volume control.
  2729.  
  2730.      You can identify an old chip by inspecting the serial interface board
  2731.      for 8250 or UM82450 type devices.  A service technician or hardware
  2732.      hacker can help if you are not familiar with reading chip numbers.
  2733.  
  2734.      Dsz users can identify old chips with the following software command:
  2735.  
  2736.      EXAMPLE: dsz port 1 speed 2400 p
  2737.  
  2738.      ZCOMM and Professional-YAM users can look at the printout produced by
  2739.      the s command;  old UART chips register as TYP 0.
  2740.  
  2741.      The National Semiconductor NS16550AN is a pin compatible plug in
  2742.      replacement for 8250 and 16450 serial chips.  Omen Technology software
  2743.      enables the FIFO buffer in the NS16550AN to prevents loss of data from
  2744.      poorly written device drivers, TSR programs, etc.
  2745.  
  2746.      We are also using the Goldstar GM82C550 chip with a 9025 date code.
  2747.      This Goldstar chip is plug compatible with the National chips.  No
  2748.      problems have been discovered with this chip.
  2749.  
  2750.      The NS16550AN has better electrical characteristics than the older UART
  2751.      chips.  386 and fast 286 machines should use the NS16550AN for best
  2752.      results.  Omen Technology software has been written to allow time for
  2753.      the older UART chips to operate. However, there is a limit to how much
  2754.      the software can rearrange chip accesses without resorting to
  2755.      performance robbing wait loops.  Some other software is not as forgiving
  2756.      of slow chips.
  2757.  
  2758.      Be sure to ask for the NS16550AN.  It is VITAL to get the National
  2759.      Semiconductor "AFN" or "AN" chip.  Other vendors' chips not mentioned
  2760.      above won't do.  Current Western Digital WD16C550 chips do not function
  2761.      properly at low speeds.
  2762.  
  2763.      As of this writing, the Goldstar GM82C550  and National NS16550AN and
  2764.      NS16550FAN are the only plug compatible chips that are known to work.
  2765.  
  2766.      The Hayes ESP board comes with two serial ports with NS16550A devices.
  2767.      The ESP definitions for COM3 and COM4 agree with the industry standard
  2768.      definitions used by Omen Technology.
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.      Chapter 15 Pg 45       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2775.  
  2776.  
  2777.      The following information comes from a number of people:
  2778.  
  2779.      "I have located a small dealer in New York who has the cards with or
  2780.      without the 16550.  I believe the price is around $50.00.  The company
  2781.      is RJK Consulting and the number is 718-968-9167. The gentleman to speak
  2782.      to is a Mr. RJ Kulman. ...  I got this information off the "Interlink"
  2783.      BBS system." Fm: Nick Braak [TRICON] 75156,1254
  2784.  
  2785.      Fry's - 415-770-FRYS.  This is a Silicon Valley electronic department
  2786.      store.
  2787.  
  2788.      Jameco Electronics at 415-592-8097 sells National NS16550AN chips mail
  2789.      order (credit card) in small quantities.  Unfortunately, we have
  2790.      received a number of reports that their serial i/o card is now supplied
  2791.      with the infamous WD16C550 soldered in, even when ordered with specific
  2792.      instructions to include 16550AN chips.
  2793.  
  2794.      Microprocessors Unlimited, 24000 South Peoria, Beggs, OK. (918) 267-
  2795.      4961. The price for the chip is $13.50 plus shipping costs. No minimun
  2796.      purchase is required.
  2797.  
  2798.      Consolidated Computers 4 Shoppers Lane Suite 121 Turnersville, NJ  08012
  2799.      (609)751-9595(voice) (609)751-3843(bbs) (609)751-3840(fax)
  2800.  
  2801.      Arrow Electronics at 800-932-7769 (516-467-1000).
  2802.  
  2803.      Willies Computer Software Company: 800/835-4832.
  2804.  
  2805.      N.B.: Current Western Digital WD16C550 chips do not function properly at
  2806.      low speeds.  This has been confirmed with samples received directly from
  2807.      Western Digital.  WD is aware of this problem, but has not informed us
  2808.      of a corrected chip.
  2809.  
  2810.  
  2811.  
  2812.      15.10.1  Everex Internal Modems
  2813.      Numerous reports have been received concerning difficulties with Everex
  2814.      modem cards.  Some of these cards contain buggy 8250 chips which are not
  2815.      up to the demands of full duplex streaming protocols such as ZMODEM.
  2816.      Replacing the buggy 8250 chip with NS16550AN chip corrects these
  2817.      problems.
  2818.  
  2819.  
  2820.      15.11  Weird Iron
  2821.  
  2822.      A few machines, some with V20 CPUs, reportedly don't like DSZ.COM.  We
  2823.      have not been able to repeat this; TeleGodzilla (using a V20) runs
  2824.      DSZ.COM without a hitch.  Switching to DSZ.EXE has cleared up the
  2825.      problems on other machines.
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.      Chapter 15 Pg 46       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2834.  
  2835.  
  2836.      15.12  Will the real YMODEM please stand up?
  2837.  
  2838.      Some XMODEM programs claiming to support YMODEM neither send nor accept
  2839.      the YMODEM pathname block.  1024 byte XMODEM is XMODEM-1k, not the
  2840.      YMODEM defined by Ward Christensen in 1985 when he invented the term
  2841.      YMODEM.  1987 and later versions of YMODEM.DOC remind the reader of the
  2842.      official YMODEM definition, which has not changed since YMODEM's coinage
  2843.      in 1985.
  2844.  
  2845.  
  2846.      15.13  286 and 386 Extended Memory
  2847.  
  2848.      Virtual memory disk caches and ramdisks using 80286 or 80386 extended
  2849.      memory require a kludge hardware reset of the CPU chip to return to the
  2850.      normal "real mode" after accessing extended memory.  This interference
  2851.      to the interrupt response time causes lost characters on comm ports, and
  2852.      may be minimized by specifying shorter memory transfers.
  2853.  
  2854.      Switching to a National NS16550AN or NS16550AFN UART chip helps
  2855.      tremendously, allowing transfers at 115200 bps instead of 9600 bps with
  2856.      a standard 8250.  Please refer to the subchapter on "Brain Damaged
  2857.      UARTs".  The GSZ "handshake slow" command may also help.
  2858.  
  2859.  
  2860.      15.14  Disk Caches
  2861.  
  2862.      Cache programs often interfere with ZMODEM transfers.  In one instance,
  2863.      replacing Microsoft's SMARTDRV.SYS with Multisoft's SUPERPCK.EXE helped.
  2864.  
  2865.      Some cache programs can be turned on and off; try turning it off when
  2866.      running GSZ.
  2867.  
  2868.      Switching to a National NS16550AN or NS16550AFN UART chip helps
  2869.      tremendously, allowing transfers at 115200 bps instead of 9600 bps with
  2870.      a standard 8250.  Please refer to the subchapter on "Brain Damaged
  2871.      UARTs".  The GSZ "handshake slow" command may also help.
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.      Chapter 16 Pg 47       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2893.  
  2894.  
  2895.      16.  ASSOCIATED DOCUMENTS
  2896.  
  2897.      Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS
  2898.      FOR FILE TRANSFERS" for descriptions of the file transfer options.  The
  2899.      "FILE TRANSFER BASICS" chapter explains the relative merits of XMODEM,
  2900.      YMODEM, ZMODEM, and other protocols and gives tips on their use.  The
  2901.      "MAIN COMMANDS" chapter describes the rb, rx, rc, rz, sb, and sz
  2902.      commands.  The "MODEM INTERFACING" and "FLOW CONTROL" chapters contain
  2903.      important information on the use of buffered modems with GSZ.
  2904.  
  2905.      Information on the ZMODEM Inter Application File Transfer Protocol is
  2906.      available in Omen Technology's "ZMODEM DEVELOPER's COLLECTION" ($89.00).
  2907.  
  2908.      Unix/Xenix C Source code for XMODEM, YMODEM, and ZMODEM transfers
  2909.      to/from Omen Technology Products is included in RZSZ.ZOO.[1] This file
  2910.      includes a Pro-YAM/ZCOMM script to upload a bootstrap file to a Unix
  2911.      system, compile it, and (if the compilation is successful) upload the
  2912.      rz/sz source files.
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.      __________
  2943.  
  2944.       1. Technical support for rzsz is available on a paid consulting basis.
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.      Chapter 17 Pg 48       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  2952.  
  2953.  
  2954.      17.  FILES
  2955.  
  2956.      DSZ.COM, DSZ.DOC, 2A-PIF.DVP, 2S-PIF.DVP, 2T-PIF.DVP, BBS_REG.TXT,
  2957.      DS.BAT, FIX.BAT, MAILER, ZMODEMAD.BAT, ZMODEMD.BAT, ZMODEMDR.BAT, and
  2958.      ZMODEMU.BAT constitute Omen Technology's DSZ.ZIP.  These same files are
  2959.      in DSZ.ZOO on the distribution diskette mailed to registered users.[1]
  2960.  
  2961.      2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, and 2T-PIF.DVP are used with Quarterdeck
  2962.      Office Systems' DESQview multitasking executive for background
  2963.      operation.  Their use is described in a previous chapter of this
  2964.      document.
  2965.  
  2966.      DGSZ.ZOO is distributed to GSZ registrants.  It contains GSZ.EXE and
  2967.      GCOLORS.EXE in addition to the above.
  2968.  
  2969.      ZCOMMDOC.ZIP (manual), ZCOMMEXE.ZIP (programs), ZCOMMHLP.ZIP (help
  2970.      processor and database), make up the ZCOMM communications tools
  2971.      shareware distribution.  The ZCOMM files are available on finer bulletin
  2972.      boards.
  2973.  
  2974.      RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE Unix/Xenix
  2975.      programs licensed for use transferring files to/from licensed Omen
  2976.      Technology products.[2]
  2977.  
  2978.      RZSZ.TLB The ZMODEM rz/sz programs are available in native VMS flavors
  2979.      with wild cards, record format support, etc..  Pre compiled VAX/VMS
  2980.      files are contained in the RZSZ.TLB compressed text library.
  2981.  
  2982.      DSZ.EXE compiled with the Xenix to DOS XC may give moderately higher
  2983.      maximum throughput noticeable on slower machines.  Sending from a faster
  2984.      machine to an 8 MHz IBM AT with 16550FAN, using 115200 bps and "sz -yZ
  2985.      rttypix":
  2986.  
  2987.      Program                       Throughput
  2988.  
  2989.      DSZ.EXE                       12735 cps
  2990.      DSZ.COM                       7164 cps
  2991.  
  2992.      ProComm+2.0                   5928 cps
  2993.  
  2994.  
  2995.  
  2996.      __________
  2997.  
  2998.       1. DSZ.ZOO is supplied to registrants instead of DSZ.ZIP because not
  2999.          all registrants have copies of unarchiving programs.  The
  3000.          registration disk includes a copy of BOOZ, a simple dearchiver for
  3001.          ZOO files.
  3002.  
  3003.       2. Technical support for rzsz is available on a paid consulting basis.
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.      Chapter 17 Pg 49       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3011.  
  3012.  
  3013.      (Compare these speeds to those listed on Page 159 of the April 30, 1991
  3014.      issue of PC Magazine.)
  3015.  
  3016.      DSZ.EXE supports ZMODEM over 7 bit paths (E and P options), and
  3017.      specified control character quoting (-Q<string> option).  The DSZ.EXE
  3018.      requires somewhat more memory than DSZ.COM.  DSZ.EXE does not support
  3019.      file sharing due to brain damage in the Microsoft C library.  The
  3020.      maximum DSZ.EXE I/O buffer size available with the B numeric parameter
  3021.      is 16384.  DSZ.EXE is available in DSZEXE.ZIP and DSZEXE.ZOO.
  3022.  
  3023.      ZCOMM and Pro-YAM also run faster than GSZ.COM.
  3024.  
  3025.      DSZBG.ZOO contains DSZBG.DOC.  Part of the GSZ registration disk, this
  3026.      file provides background information on the ZCOMM/Pro-YAM commands
  3027.      provided in DSZ and GSZ.
  3028.  
  3029.      The ZOO archive format is a machine independent improvement on the PC-
  3030.      DOS specific .ARC format. The ZOO format has been precisely defined, and
  3031.      stable ZOO archivers/dearchivers are available on a wide variety of
  3032.      systems.
  3033.  
  3034.      BOOZ.EXE unpacks .ZOO archives.  BOOZ.DOC describes BOOZ.EXE.
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.      Chapter 18 Pg 50       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3070.  
  3071.  
  3072.      18.  Other Omen Technology Products
  3073.  
  3074.      18.1  Professional-YAM COMMS TOOLS
  3075.  
  3076.      Omen Technology makes Professional-YAM, a comprehensive comms program
  3077.      with unmatched power.  Flavors are available for PC-DOS, Unix, Xenix,
  3078.      and OS/2 Protected mode.  Unix source code is available under license.
  3079.  
  3080.  
  3081.      18.2  ZCOMM: Industrial Strength COMMS Shareware
  3082.  
  3083.      ZCOMM is a full featured shareware version with a $40.00 basic
  3084.      registration.  Registered GSZ users upgrading to ZCOMM get a free
  3085.      binder!
  3086.  
  3087.  
  3088.      18.3  ZMODEM Developer's Collection
  3089.  
  3090.      Omen Technology sells the "ZMODEM Developer's Collection" for $89.00.
  3091.      This diskette includes the most recent public domain versions of
  3092.      YMODEM.DOC, ZMODEM.DOC and the Unix/VMS rz/sz C source code for YMODEM
  3093.      and ZMODEM.  Porting to the intended application is the sole
  3094.      responsibility of the purchaser.  For many developers, this collection
  3095.      affords a significant labor savings in obtaining these materials.
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.      Chapter 19 Pg 51       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3129.  
  3130.  
  3131.      19.  FAIR PLAY
  3132.  
  3133.      Unlike snazzy menu interfaces, reliable high speed transfer protocols
  3134.      take many hours of testing, often over expensive phone connections, to
  3135.      develop.  Two decades of communications experience and protocol testing
  3136.      are distilled in GSZ.
  3137.  
  3138.      GSZ is a user supported program developed and supported by Chuck
  3139.      Forsberg, owner of Omen Technology.  Countless hours of work and
  3140.      expen$ive resources went to develop and support GSZ for the myriad
  3141.      environments users use it in.  The fact that most of the problems people
  3142.      encounter with GSZ are caused by other software, hardware problems,
  3143.      failure to read the supplied documentation, or pirating has not kept
  3144.      users from seeking and getting help, even if it means calling the author
  3145.      in the middle of his sleep.
  3146.  
  3147.      Beyond this, the world of communications is constantly evolving, and it
  3148.      requires a significant ongoing effort to keep GSZ and its documentation
  3149.      up to date with the current state of the art.  Individuals with little
  3150.      knowledge of the dynamic nature of telecommunications (or hidden
  3151.      agendas) have misrepresented the frequency of enhancements to GSZ as a
  3152.      sign that GSZ is "unstable" and unworthy of "serious consideration".  If
  3153.      you think such sniping is fair play, you are more than welcome to use
  3154.      one of the many other protocol programs available, each of which claim
  3155.      to offer speed and reliability comparable to GSZ.
  3156.  
  3157.      Non registered users are welcome to use GSZ for a reasonable evaluation
  3158.      period.  "Reasonable" means "until you've decided whether the program is
  3159.      worth $30.00." It does not mean "until some competing program gets
  3160.      around to adding ZMODEM or True Ymodem(TM)".  Once you've evaluated GSZ,
  3161.      ethical use of GSZ requires registering the copy.
  3162.  
  3163.      GSZ is not and never has been Public Domain.  Every version of GSZ has
  3164.      included a Copyright Notice and a prohibition against sale or
  3165.      modification.  There is no usage counter or other Trojan Horse in GSZ,
  3166.      but if you use this program, you have a moral and ethical obligation to
  3167.      register it.
  3168.  
  3169.      Paid registration enables t -8g, DIRRX, DSZOPT, OverThruster(TM),
  3170.      YMODEM-g, and other advanced features that are present in GSZ.ARC in
  3171.      encrypted form.  The registration package serializes and decodes all
  3172.      past and future versions of GSZ.COM and GSZ.EXE.  You can get a fully
  3173.      featured upgrade of GSZ simply by downloading a newer version from
  3174.      TeleGodzilla, GEnie (IBM Roundtable), CompuServe, and trusted bulletin
  3175.      boards.
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.      Chapter 19 Pg 52       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3188.  
  3189.  
  3190.      19.1  Sharing GSZ Files
  3191.  
  3192.      You are welcome to share unmodified copies of GSZ.ZIP or GSZ.ZOO with
  3193.      your friends and associates for their evaluation.  This documentation
  3194.      file and the MAILER file must be provided with all copies of GSZ except
  3195.      by prior written permission from Omen Technology Inc.  Because of piracy
  3196.      problems, Omen Technology must INSIST that GSZ be distributed only as
  3197.      part of the GSZ.ZIP file EXACTLY as provided by Omen Technology Inc, or
  3198.      in an archive which displays a CRC value for GSZ.COM equal to that shown
  3199.      in the Changes chapter.  If GSZ.ZIP is repacked, no files may be added
  3200.      to or removed from the archive.
  3201.  
  3202.      If you see an improperly packed or otherwise modified GSZ archive or
  3203.      parts thereof in a bulletin board, please ask the board's operator to
  3204.      replace such files with GSZ.ZIP exactly as provided by Omen Technology
  3205.      Inc.  Flame them until they behave ethically.
  3206.  
  3207.      Unmodified copies of Omen Technology shareware and demo files including
  3208.      GSZ.ZIP, DSZ.ZIP and DSZBG.ZIP may be distributed by "shareware
  3209.      distributors" provided 1) the files are clearly identified as
  3210.      unregistered shareware, 2) the cost of the distribution is nominal.
  3211.      Otherise, no version of GSZ may be sold without the prior written
  3212.      permission of Omen Technology Inc.
  3213.  
  3214.      GSZ is not and never has been Copy Protected.  "GSZ unprotect" files
  3215.      have no function whatsoever except to aid and encourage the theft of
  3216.      Omen Technology's Intellectual Property.
  3217.  
  3218.      Distribution or use of programs or procedures that modify, patch,
  3219.      disassemble, decompile, or otherwise reverse engineer GSZ without the
  3220.      prior written permission by Omen Technology Inc is a bloody theft of
  3221.      intellectual property and services and is a violation of Federal
  3222.      Copyright Law.  The same applies to debug scripts and documentation
  3223.      written for the same purposes.  These perform the same function as
  3224.      pirate satellite and/or cable descramblers, to obtain benefit from
  3225.      encrypted communications without proper payment.  Piracy has been
  3226.      investigated by the FBI and prosecuted under federal statutes.
  3227.      Applicable law provides for damages and recovery of attorney's fees.
  3228.      Omen Technology has received reports of serious problems caused by
  3229.      unauthorized patches to GSZ, and cannot assume liability for the
  3230.      performance of the resultant code.  So far, none of the slime producing
  3231.      such bilge have seen fit to sign their real name and address to their
  3232.      cretinous attempts at ego gratification.
  3233.  
  3234.      Distribution of GSZ in any medium without this documentation file is an
  3235.      unauthorized modification to GSZ that deprives the rightful author of
  3236.      registration revenues.  That is a theft of intellectual property.  Such
  3237.      distribution damages the author by forcing the user and author to waste
  3238.      time and phone bills scrounging for the documentation, and answering
  3239.      questions that are fully covered in the documentation.
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.      Chapter 19 Pg 53       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3247.  
  3248.  
  3249.      If any version of GSZ is distributed with any other product, software or
  3250.      hardware, the product documentation must clearly and prominently state
  3251.      that the customer's continued use of GSZ requires registration directly
  3252.      with Omen Technology or its duly authorized agent(s).  When unregistered
  3253.      copies of GSZ are distributed on disk, a contemporary copy of
  3254.      ZCOMMDOC.ZIP should be included on the same disk.
  3255.  
  3256.      Thank you for your support.
  3257.  
  3258.      19.2  REGISTRATION
  3259.  
  3260.  
  3261.      DSZ Upgrade!!  Include your PAID REGISTRATION DSZ SNP card and take
  3262.      $15.00 off the registration fee!!  (The card must be mailed with the
  3263.      order.) (Be sure to copy your DSZ SNP for safe keeping.)  After a short
  3264.      evaluation period, ethical users must register their copy of GSZ with a
  3265.      check for $30.00 in U.S. funds sent to:
  3266.  
  3267.             Omen Technology Inc.
  3268.             P.O. Box 4681
  3269.             Portland, OR 97208
  3270.  
  3271.      The address on your check is sufficient, no need to fill out forms.
  3272.  
  3273.             For VISA/MC Registrations, you can also:
  3274.             Call VOICE: 503-621-3406
  3275.  
  3276.             Or register online: 503-621-3746  300-1200-2400 bps
  3277.             Or FAX the INSTANT MAILER to: 503-621-3735
  3278.  
  3279.      Don't bother scrounging for an envelope, just print the INSTANT MAILER
  3280.      included in this archive!
  3281.  
  3282.      Overseas registrations are sent out International Air Mail.  Users,
  3283.      especially those overseas, may choose to register their copy of GSZ for
  3284.      $35.00 U.S.  by providing their VISA or Mastercard card number with
  3285.      expiration date and their name as it appears on their credit card.
  3286.  
  3287.      Purchase orders for less than $150 must be prepaid.  Omen Technology Inc
  3288.      Federal TAX ID #: 930858776 Oregon TAX ID #: 536565
  3289.       .ne 12
  3290.  
  3291.      "Das Recht zur Benutzung von DSZ in Deutschland, Oesterreich und der
  3292.      Schweiz erwerben Sie durch Bezahlung der Lizenzgebuehr von DM 57,00
  3293.      (incl. Mwst) an RzK
  3294.  
  3295.      Doris Koepke
  3296.      Bitzenstr. 11
  3297.      D-5464 Asbach
  3298.  
  3299.      Tel. 02683-4547, FAX 49 2683 4537, Telex 86 3705 rzk d, CIS
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.      Chapter 19 Pg 54       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3306.  
  3307.  
  3308.      [70126,1660]. Sie erhalten dann von dort sowohl die neueste Version, als
  3309.      auch Ihren individuellen Software-Key, mit dem Sie auch kuenftige
  3310.      Shareware-Versionen "aufschliessen", also die in der Shareware Version
  3311.      nicht zugnglichen Programmfunktionen nutzbar machen koennen, per Post.
  3312.      Die Benutzung nicht registrierter Versionen stellt einen Verstoss
  3313.      geltenden Rechts dar und wird strafrechtlich verfolgt."
  3314.  
  3315.  
  3316.      *************************************************************************
  3317.      The user registration package includes a printed serial number password
  3318.      (SNP) card.  The registration "care package" diskette contains the
  3319.      latest versions of the GSZ programs, additional user documentation, and
  3320.      the installation program which uses your personal SNP to enable advanced
  3321.      features and bypass the opening advertisement.
  3322.  
  3323.      The registration package unlocks the extra value in all past and future
  3324.      versions of GSZ.COM and GSZ.EXE.
  3325.      *************************************************************************
  3326.  
  3327.      The unique serial number on the registration card is registered to the
  3328.      user, and is acceptable proof of registration to corporate auditors.
  3329.  
  3330.      The putsnp program inserts your unique DSZ Serial Number Password (SNP)
  3331.      into you copy of DSZ with the following command:
  3332.             putsnp dsz.com
  3333.      Putsnp prompts for your SNP and asks appropriate questions before
  3334.      inserting the SNP to enable the extra value in DSZ.
  3335.  
  3336.      GSZ is serilized with the GCOLORS program described above.
  3337.  
  3338.      Some TSR programs and device deivers interfere with putsnp.  If you have
  3339.      a lockup running putsnp, run it without any device drivers or TSR
  3340.      programs (boot a plain DOS from floppy disk).
  3341.  
  3342.      Your disk directory entry for GSZ will show the date and time you
  3343.      serialized your copy of GSZ.  This does not affect the revision date GSZ
  3344.      announces when GSZ is run.
  3345.  
  3346.  
  3347.      The only legitimate way to disable the opening advertisement in GSZ is
  3348.      to insert an authorized serial number and activation key obtained from
  3349.      Omen Technology into GSZ with the gcolors program.  Any other
  3350.      suppression or modification of the opening screen is an illegal,
  3351.      unethical theft of services.  Omen Technology has received reports of
  3352.      serious problems caused by unauthorized patches to GSZ, and cannot
  3353.      assume liability for the performance of the resultant code.
  3354.  
  3355.      Piracy is stealing.
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.      Chapter 19 Pg 55       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3365.  
  3366.  
  3367.      19.3  Files on Registration Disk
  3368.  
  3369.      The following files are currently included on the Registration Disk sent
  3370.      to paid registrants.
  3371.  
  3372.      BOOZ.EXE       Program to unpack .ZOO archives.  BOOZ.DOC describes
  3373.                     BOOZ.EXE.
  3374.  
  3375.  
  3376.      DSZEXE.ZOO     Contains DSZ.EXE.
  3377.  
  3378.                     To dearchive with booz: booz x dszexe
  3379.  
  3380.                     Type "booz" without arguments to see the help message.
  3381.  
  3382.  
  3383.  
  3384.      DSZ.ZOO        Contains DSZ.COM, DSZ.DOC, DESQview description files.
  3385.  
  3386.                     To dearchive with booz: booz x dsz
  3387.  
  3388.  
  3389.      DGSZ.ZOO       Contains GSZ, DSZ, GSZ.DOC, and DESQview description
  3390.                     files.
  3391.  
  3392.                     To dearchive with booz: booz x dsz
  3393.  
  3394.                     RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE VAX
  3395.                     VMS and Unix/Xenix programs licensed for use transferring
  3396.                     files to/from licensed Omen Technology products.[1]
  3397.  
  3398.                     To dearchive RZSZ with booz: booz x rzsz
  3399.  
  3400.  
  3401.      PUTSNP.EXE     Installs your unique registered serial number to enable
  3402.                     the extra value in DSZ.
  3403.  
  3404.  
  3405.      DSZBG.DOC      (in DSZBG.ZOO) Background information for GSZ and DSZ,
  3406.                     consisting of relevant parts of the ZCOMM User's Manual.
  3407.  
  3408.                     To dearchive with booz: booz x dszbg
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.      __________
  3415.  
  3416.       1. Technical support for rzsz is available on a paid consulting basis.
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.      Chapter 19 Pg 56       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3424.  
  3425.  
  3426.      19.4  Bulletin Board Registration
  3427.  
  3428.      Note to the wise BBS operator: be sure you understand the GSZ restrict
  3429.      command and how to use it.
  3430.  
  3431.      Use and/or copying of GSZ by bulletin board sysops and/or systems is
  3432.      allowed according to the following conditions:
  3433.  
  3434.      I agree to feature the ZCOMM files (ZCOMMEXE.ZIP, ZCOMMDOC.ZIP,
  3435.      ZCOMMHLP.ZIP) for downloading, and to announce the availability and
  3436.      features of ZCOMM in any bulletins, help displays, or other displays
  3437.      that mention communications programs.  It is my responsibility to
  3438.      maintain reasonably current versions of the ZCOMM files on the BBS shown
  3439.      above.
  3440.  
  3441.      I understand that I am welcome to use GSZ on my bulletin board(s) from
  3442.      the time I sign and mail this document as long as I abide by the
  3443.      conditions above, including featuring the above mentioned ZCOMM files.
  3444.  
  3445.      I shall distribute GSZ.COM only as part of the GSZ.ZIP EXACTLY as
  3446.      provided by Omen Technology Inc, or "zipped" without any file additions,
  3447.      deletions, or modifications.  If I distribute GSZEXE.ZOO, I shall also
  3448.      maintain GSZ.ZIP in the same directory since GSZEXE.ZOO references files
  3449.      in GSZ.ZIP.
  3450.  
  3451.      If I see a modified GSZ archive or parts thereof in a file or collection
  3452.      of files (e.g., archive) on a bulletin board, I shall replace such files
  3453.      or archive members with the contents of GSZ.ZIP exactly as provided by
  3454.      Omen Technology Inc.  I shall report instances of noncompliance to Omen
  3455.      Technology.
  3456.  
  3457.      I shall not allow any version of gsz to be sold, modified, patched,
  3458.      hacked, disassembled, decompiled, or otherwise reverse engineered
  3459.      without the prior written permission of Omen Technology Inc.
  3460.  
  3461.      I understand that GSZ is not and never has been Copy Protected.  I fully
  3462.      understand that "GSZ unprotect" files have no function whatsoever except
  3463.      to aid and encourage the theft of Omen Technology's Intellectual
  3464.      Property.
  3465.  
  3466.      (For this BBS registration, a multi node bulletin board operating from a
  3467.      single, common file system counts as one machine.)
  3468.  
  3469.      The purpose of bulletin board registrations is to support and promote
  3470.      ZCOMM and Professional-YAM by popularizing the ZMODEM protocol and
  3471.      featuring the ZCOMM shareware files available for downloading.
  3472.  
  3473.      BBS registrations must be submitted on the bbs_reg form with signature
  3474.      and date, and must accompany a new paid GSZ or ZCOMM registration.  The
  3475.      paid registration that must accompany your BBS registration can be one
  3476.      submitted by one of your board's users.  Most boards have many
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.      Chapter 19 Pg 57       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3483.  
  3484.  
  3485.      unregistered GSZ users, so getting one of them to register their GSZ
  3486.      should pose no difficulty.  Since the paid registration may be from one
  3487.      of your board's users, you can get your BBS registered for free by
  3488.      getting one of your users to register his/her GSZ at the same time.
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.      Chapter 19 Pg 58       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3542.  
  3543.  
  3544.      20.  CHANGES
  3545.  
  3546.      Be sure to save your serial number/password (SNP) card and the putsnp
  3547.      program you received from Omen Technology to use with future versions of
  3548.      DSZ you may download!
  3549.  
  3550.      Current GSZ and DSZ versions are maintained on GEnie (IBM Roundtable),
  3551.      EXEC-PC BBS, CompuServe (IBMCOM and CONSULT SIGs) as well as
  3552.      TeleGodzilla.
  3553.  
  3554.      DSZ is a popular program which has been the object of virus attacks.
  3555.      Pirated/hacked versions of DSZ have cost users and DSZ's developer
  3556.      thousands of dollars in lost time and other expenses, in addition to
  3557.      injuring of Omen Technology's reputation.
  3558.  
  3559.      Virus and Trojan code hidden in hacked/pirated copies of DSZ and
  3560.      programs claiming to "register DSZ" have caused loss of data.
  3561.  
  3562.      Name             Length                           Date        Time   CRC
  3563.  
  3564.  
  3565.  
  3566.      gcolors.exe      32736  Crunched   21%     26171   1 Oct 91   0:53a  5ceb
  3567.      gsz.exe          69984  Crunched   22%     54819   7 Oct 91   1:28a  9341
  3568.      PKZIP -vt 32 bit CRC: F6BC738C   69984  gsz.exe
  3569.      PKZIP -vt 32 bit CRC: 3AB8A2D3   32736  gcolors.exe
  3570.  
  3571.  
  3572.      Your copy of GSZ should show this information as provided by
  3573.  
  3574.             arc v gsz
  3575.      or
  3576.            pkxarc -v gsz
  3577.            lharc v gsz
  3578.  
  3579.      ARC, and LHARC use a 16 bit CRC.
  3580.  
  3581.  
  3582.      ZIP uses a 32 bit CRC compatible with  the  Professional-YAM  and  ZCOMM
  3583.      "crc" command.
  3584.            pkzip -vt gsz
  3585.      The following Pro-YAM/ZCOMM command gives the 32 bit CRC for GSZ.COM:
  3586.  
  3587.      EXAMPLE: >>>c: crc gsz.com
  3588.  
  3589.  
  3590.      If your copy shows a different CRC or file length, insist on a
  3591.      legitimate copy and report the source of the bogus/pirated copy to Omen
  3592.      Technology Inc.  Omen Technology has received reports of serious
  3593.      problems caused by unauthorized patches to DSZ, and cannot assume
  3594.      liability for the performance of the resultant code.
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.      Chapter 20 Pg 59       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3601.  
  3602.  
  3603.      Good news for tired frog stompers!  The ZMODEM rz/sz programs are
  3604.      available in native VMS flavors with wild cards, record format support,
  3605.      etc..  Pre compiled VAX/VMS files are contained in the RZSZ.TLB
  3606.      compressed text library.
  3607.  
  3608.      The DSZ and GSZ "t" command uses the DOS console driver for terminal
  3609.      emulation.  Standard ANSI.SYS is limited to a small subset of ANSI
  3610.      escape sequences; NANSI.SYS, FANSI-Console and other replacement console
  3611.      drivers provide faster screen updates and better ANSI terminal
  3612.      emulation.
  3613.  
  3614.      Oct 7 1991: The "t" (talk) command now accepts -h and -H to enable local
  3615.      echo.
  3616.  
  3617.      Oct 1 1991: Fixed an interaction between FIFO uarts and YMODEM-g
  3618.      termination after all files have been sent.  Fixed problem of some
  3619.      options being ignored on XMODEM and YMODEM downloads.  Fixed graphics
  3620.      display problem involving more than 40 MB of files.
  3621.  
  3622.  
  3623.      Sep 4 1991: GCOLORS now saves the color scheme in a separate file
  3624.      GCOLORS.T.  Many small improvements in the GSZ file xfer display.
  3625.      GCOLORS adds a "m" menu choice to remove color from the color scheme.
  3626.  
  3627.      A conflict between crash recovery and user specified short packets has
  3628.      been corrected.
  3629.  
  3630.      DSZ.EXE and GSZ now accept the "c" option to force incoming files to use
  3631.      a changed file name when a file with the same name exists.  The
  3632.      receiving program must support this new ZMODEM option or file
  3633.      disposition will be undefined.
  3634.  
  3635.      Aug 7 1991: Serial I/O modifications have solved a Wedge-O-Matic(R)
  3636.      problem with one hardware configuration (antique 2400 bps internal
  3637.      modem).  Hopefully this will solve similar non-replicatable problems for
  3638.      other users.
  3639.  
  3640.      A number of display fixes/enhancements to GSZ, including the addition of
  3641.      the GSZWINDOW environment variable enabling BBS sysops to protect BBS
  3642.      status lines at the bottom of the screen.
  3643.  
  3644.  
  3645.      July 29 1991: Corrections to gcolors registration function.
  3646.  
  3647.      July 28 1991: Some changes to GSZ and CGOLORS to improve human factors.
  3648.  
  3649.      "GCOLORS -q" disables the flashing reminder of which field is being
  3650.      modified.  This was added to help users with certain visual impairments.
  3651.  
  3652.      A few users have reported hung transfers wither certain hardware and/or
  3653.      software configurations.  We have not been able to replicate the
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.      Chapter 20 Pg 60       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3660.  
  3661.  
  3662.      problem, but have added code that recovers from lost interrupts.
  3663.  
  3664.      July 21 1991: Preview release of GSZ!!
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.      Chapter 21 Pg 61       GSZ Reference Rev Oct-7-91        Typeset 10-7-91
  3719.  
  3720.  
  3721.      21.  ACKNOWLEDGEMENTS
  3722.  
  3723.      32 bit CRC code courtesy Gary S. Brown.
  3724.  
  3725.      ZMODEM-90(TM), MobyTurbo(TM), The High Reliability Software(TM), Demand
  3726.      Upgrade(TM), TurboLearn Script Writer(TM), Cybernetic Data Recovery(TM),
  3727.      ZMODEM AutoDownload(TM), Intelligent Crash Recovery(TM), Error
  3728.      Containment(TM), Full Time Capture(TM), True YMODEM(TM),
  3729.      OverThruster(TM), Password Guardian(TM), CryptoScript(TM), and
  3730.      TurboDial(TM) are Omen Technology trademarks.
  3731.  
  3732.      PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro
  3733.      Oregon.
  3734.  
  3735.      True YMODEM(TM) is an Omen Technology Trademark signifying YMODEM
  3736.      protocol support that meets the full YMODEM specification.
  3737.  
  3738.      GSZ and this documentation are Copyright 1991 by Omen Technology Inc,
  3739.      all rights reserved.  GSZ is not and never has been Public Domain.
  3740.      Every version of DSZ has included a Copyright Notice and a prohibition
  3741.      against sale or modification.  This prohibition applies to any theft of
  3742.      the intellectual property and trade secrets contained in GSZ by
  3743.      decompilation, disassembly, or any other form of reverse engineering
  3744.      including but not limited to profiling, tracing, data analysis, or
  3745.      monitoring the operation of GSZ.
  3746.  
  3747.      Omen Technology copyright applies to its expression of the encoding and
  3748.      compression ideas expressed as code and byte streams used in the
  3749.      ZMODEM-90 enhancements.
  3750.  
  3751.      GSZ is not and never has been Copy Protected.  "GSZ unprotect" files
  3752.      have no function whatsoever except to aid and encourage the theft of
  3753.      Omen Technology's Intellectual Property.
  3754.  
  3755.                            Omen Technology Incorporated
  3756.                           The High Reliability Software
  3757.  
  3758.                        17505-V Northwest Sauvie Island Road
  3759.                               Portland Oregon 97231
  3760.                     Modem: 503-621-3746 Speed 1200,2400,19200
  3761.                                 FAX: 503-621-3735
  3762.                          CompuServe:70007,2304  GEnie:CAF
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.